@xopcai/xopc 0.0.116 → 0.0.118

package/dist/src/agent-manifest/resolver.d.ts

@@ -0,0 +1,12 @@
+import { type AgentConfigEntry, type CapabilityPreset, type EffectiveAgentManifest } from './schema.js';
+export interface ResolveManifestResult {
+    manifest: EffectiveAgentManifest;
+    sources: Record<string, string>;
+}
+export interface ResolveManifestParams {
+    agent: AgentConfigEntry;
+    presets?: Record<string, CapabilityPreset>;
+    defaultPresetId?: string;
+}
+export declare function resolveEffectiveAgentManifest(params: ResolveManifestParams): ResolveManifestResult;
+export declare function getManifestSource(result: ResolveManifestResult, path: string): string | undefined;

package/dist/src/agent-manifest/resolver.js

@@ -0,0 +1,95 @@
+import { AgentConfigEntrySchema, AgentManifestSchema, CapabilityPresetSchema, init_schema } from "./schema.js";
+//#region src/agent-manifest/resolver.ts
+init_schema();
+function isObject(value) {
+	return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+function clone(value) {
+	return value === void 0 ? value : structuredClone(value);
+}
+function pathJoin(base, key) {
+	return base ? `${base}.${key}` : key;
+}
+function collectLeafSources(value, source, path, out) {
+	if (Array.isArray(value)) {
+		out[path] = source;
+		return;
+	}
+	if (isObject(value)) {
+		for (const [key, child] of Object.entries(value)) collectLeafSources(child, source, pathJoin(path, key), out);
+		return;
+	}
+	if (path) out[path] = source;
+}
+function mergeInto(target, patch, params) {
+	for (const [key, patchValue] of Object.entries(patch)) {
+		const path = pathJoin(params.basePath ?? "", key);
+		if (params.locks.has(path) || [...params.locks].some((lock) => path.startsWith(`${lock}.`))) continue;
+		if (isObject(patchValue) && isObject(target[key])) {
+			mergeInto(target[key], patchValue, {
+				...params,
+				basePath: path
+			});
+			continue;
+		}
+		target[key] = clone(patchValue);
+		collectLeafSources(patchValue, params.source, path, params.sources);
+		for (const lock of params.patchLocks ?? []) {
+			const lockPath = pathJoin(path, lock);
+			params.locks.add(lockPath);
+		}
+	}
+}
+function resolvePresetChain(presetId, presets, stack, out) {
+	if (stack.includes(presetId)) throw new Error(`Capability preset cycle detected: ${[...stack, presetId].join(" -> ")}`);
+	const preset = presets[presetId];
+	if (!preset) throw new Error(`Capability preset "${presetId}" was not found`);
+	for (const parent of preset.extends ?? []) resolvePresetChain(parent, presets, [...stack, presetId], out);
+	out.push(preset);
+}
+function presetPatch(preset) {
+	const { id: _id, name: _name, description: _description, version: _version, extends: _extends, locks: _locks, ...patch } = preset;
+	return patch;
+}
+function resolveEffectiveAgentManifest(params) {
+	const agent = AgentConfigEntrySchema.parse(params.agent);
+	const presets = Object.fromEntries(Object.entries(params.presets ?? {}).map(([id, preset]) => [id, CapabilityPresetSchema.parse(preset)]));
+	const defaultPresetId = params.defaultPresetId ?? "default";
+	const presetIds = [...presets[defaultPresetId] ? [defaultPresetId] : [], ...(agent.extends ?? []).filter((id) => id !== defaultPresetId)];
+	const chain = [];
+	for (const presetId of presetIds) resolvePresetChain(presetId, presets, [], chain);
+	const merged = {};
+	const sources = {};
+	const locks = /* @__PURE__ */ new Set();
+	for (const preset of chain) {
+		mergeInto(merged, presetPatch(preset), {
+			source: `preset:${preset.id}@${preset.version}`,
+			sources,
+			locks,
+			patchLocks: preset.locks
+		});
+		for (const lock of preset.locks ?? []) locks.add(lock);
+	}
+	const { extends: _extends, ...agentPatch } = agent;
+	mergeInto(merged, agentPatch, {
+		source: `agent:${agent.id}`,
+		sources,
+		locks
+	});
+	return {
+		manifest: AgentManifestSchema.parse({
+			...merged,
+			id: agent.id,
+			enabled: agent.enabled,
+			extends: agent.extends
+		}),
+		sources
+	};
+}
+function getManifestSource(result, path) {
+	return result.sources[path];
+}
+//#endregion
+export { getManifestSource, resolveEffectiveAgentManifest };
+
+//# sourceMappingURL=resolver.js.map

package/dist/src/agent-manifest/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","names":[],"sources":["../../../src/agent-manifest/resolver.ts"],"sourcesContent":["import {\n  AgentConfigEntrySchema,\n  AgentManifestSchema,\n  CapabilityPresetSchema,\n  DEFAULT_CAPABILITY_PRESET_ID,\n  type AgentConfigEntry,\n  type CapabilityPreset,\n  type EffectiveAgentManifest,\n} from './schema.js';\n\nexport interface ResolveManifestResult {\n  manifest: EffectiveAgentManifest;\n  sources: Record<string, string>;\n}\n\nexport interface ResolveManifestParams {\n  agent: AgentConfigEntry;\n  presets?: Record<string, CapabilityPreset>;\n  defaultPresetId?: string;\n}\n\ntype JsonObject = Record<string, unknown>;\n\nfunction isObject(value: unknown): value is JsonObject {\n  return Boolean(value && typeof value === 'object' && !Array.isArray(value));\n}\n\nfunction clone<T>(value: T): T {\n  return value === undefined ? value : structuredClone(value);\n}\n\nfunction pathJoin(base: string, key: string): string {\n  return base ? `${base}.${key}` : key;\n}\n\nfunction collectLeafSources(value: unknown, source: string, path: string, out: Record<string, string>): void {\n  if (Array.isArray(value)) {\n    out[path] = source;\n    return;\n  }\n  if (isObject(value)) {\n    for (const [key, child] of Object.entries(value)) {\n      collectLeafSources(child, source, pathJoin(path, key), out);\n    }\n    return;\n  }\n  if (path) {\n    out[path] = source;\n  }\n}\n\nfunction mergeInto(\n  target: JsonObject,\n  patch: JsonObject,\n  params: {\n    source: string;\n    sources: Record<string, string>;\n    locks: Set<string>;\n    patchLocks?: readonly string[];\n    basePath?: string;\n  },\n): void {\n  for (const [key, patchValue] of Object.entries(patch)) {\n    const path = pathJoin(params.basePath ?? '', key);\n    if (params.locks.has(path) || [...params.locks].some((lock) => path.startsWith(`${lock}.`))) {\n      continue;\n    }\n    if (isObject(patchValue) && isObject(target[key])) {\n      mergeInto(target[key] as JsonObject, patchValue, { ...params, basePath: path });\n      continue;\n    }\n    target[key] = clone(patchValue);\n    collectLeafSources(patchValue, params.source, path, params.sources);\n    for (const lock of params.patchLocks ?? []) {\n      const lockPath = pathJoin(path, lock);\n      params.locks.add(lockPath);\n    }\n  }\n}\n\nfunction resolvePresetChain(\n  presetId: string,\n  presets: Record<string, CapabilityPreset>,\n  stack: string[],\n  out: CapabilityPreset[],\n): void {\n  if (stack.includes(presetId)) {\n    throw new Error(`Capability preset cycle detected: ${[...stack, presetId].join(' -> ')}`);\n  }\n  const preset = presets[presetId];\n  if (!preset) {\n    throw new Error(`Capability preset \"${presetId}\" was not found`);\n  }\n  for (const parent of preset.extends ?? []) {\n    resolvePresetChain(parent, presets, [...stack, presetId], out);\n  }\n  out.push(preset);\n}\n\nfunction presetPatch(preset: CapabilityPreset): JsonObject {\n  const {\n    id: _id,\n    name: _name,\n    description: _description,\n    version: _version,\n    extends: _extends,\n    locks: _locks,\n    ...patch\n  } = preset;\n  return patch as JsonObject;\n}\n\nexport function resolveEffectiveAgentManifest(params: ResolveManifestParams): ResolveManifestResult {\n  const agent = AgentConfigEntrySchema.parse(params.agent);\n  const presets = Object.fromEntries(\n    Object.entries(params.presets ?? {}).map(([id, preset]) => [id, CapabilityPresetSchema.parse(preset)]),\n  );\n  const defaultPresetId = params.defaultPresetId ?? DEFAULT_CAPABILITY_PRESET_ID;\n  const presetIds = [\n    ...(presets[defaultPresetId] ? [defaultPresetId] : []),\n    ...(agent.extends ?? []).filter((id) => id !== defaultPresetId),\n  ];\n  const chain: CapabilityPreset[] = [];\n  for (const presetId of presetIds) {\n    resolvePresetChain(presetId, presets, [], chain);\n  }\n\n  const merged: JsonObject = {};\n  const sources: Record<string, string> = {};\n  const locks = new Set<string>();\n  for (const preset of chain) {\n    mergeInto(merged, presetPatch(preset), {\n      source: `preset:${preset.id}@${preset.version}`,\n      sources,\n      locks,\n      patchLocks: preset.locks,\n    });\n    for (const lock of preset.locks ?? []) {\n      locks.add(lock);\n    }\n  }\n\n  const { extends: _extends, ...agentPatch } = agent;\n  mergeInto(merged, agentPatch as JsonObject, {\n    source: `agent:${agent.id}`,\n    sources,\n    locks,\n  });\n\n  return {\n    manifest: AgentManifestSchema.parse({ ...merged, id: agent.id, enabled: agent.enabled, extends: agent.extends }),\n    sources,\n  };\n}\n\nexport function getManifestSource(result: ResolveManifestResult, path: string): string | undefined {\n  return result.sources[path];\n}\n"],"mappings":"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"}