@skild/core 0.2.6 → 0.2.7

package/dist/index.d.ts

@@ -167,6 +167,13 @@ declare function searchRegistrySkills(registryUrl: string, query: string, limit?
     created_at?: string;
     updated_at?: string;
 }>>;
+declare function resolveRegistryAlias(registryUrl: string, alias: string): Promise<{
+    type: 'registry';
+    spec: string;
+} | {
+    type: 'linked';
+    spec: string;
+}>;
 declare function downloadAndExtractTarball(resolved: RegistryResolvedVersion, tempRoot: string, stagingDir: string): Promise<void>;
 
 interface InstallInput {
@@ -204,4 +211,4 @@ declare function uninstallSkill(name: string, options?: InstallOptions & {
 }): void;
 declare function updateSkill(name?: string, options?: UpdateOptions): Promise<InstallRecord[]>;
 
-export { DEFAULT_REGISTRY_URL, type DependencySourceType, type GlobalConfig, type InstallOptions, type InstallRecord, type InstallScope, type InstalledDependency, type ListOptions, type Lockfile, PLATFORMS, type Platform, type RegistryAuth, SkildError, type SkillFrontmatter, type SkillValidationIssue, type SkillValidationResult, type UpdateOptions, canonicalNameToInstallDirName, clearRegistryAuth, downloadAndExtractTarball, fetchWithTimeout, getSkillInfo, getSkillInstallDir, getSkillsDir, initSkill, installRegistrySkill, installSkill, listAllSkills, listSkills, loadOrCreateGlobalConfig, loadRegistryAuth, parseRegistrySpecifier, resolveRegistryUrl, resolveRegistryVersion, saveRegistryAuth, searchRegistrySkills, splitCanonicalName, uninstallSkill, updateSkill, validateSkill, validateSkillDir };
+export { DEFAULT_REGISTRY_URL, type DependencySourceType, type GlobalConfig, type InstallOptions, type InstallRecord, type InstallScope, type InstalledDependency, type ListOptions, type Lockfile, PLATFORMS, type Platform, type RegistryAuth, SkildError, type SkillFrontmatter, type SkillValidationIssue, type SkillValidationResult, type UpdateOptions, canonicalNameToInstallDirName, clearRegistryAuth, downloadAndExtractTarball, fetchWithTimeout, getSkillInfo, getSkillInstallDir, getSkillsDir, initSkill, installRegistrySkill, installSkill, listAllSkills, listSkills, loadOrCreateGlobalConfig, loadRegistryAuth, parseRegistrySpecifier, resolveRegistryAlias, resolveRegistryUrl, resolveRegistryVersion, saveRegistryAuth, searchRegistrySkills, splitCanonicalName, uninstallSkill, updateSkill, validateSkill, validateSkillDir };

package/dist/index.js

@@ -360,6 +360,24 @@ async function searchRegistrySkills(registryUrl, query, limit = 50) {
   }
   return json.skills;
 }
+async function resolveRegistryAlias(registryUrl, alias) {
+  const a = alias.trim();
+  if (!a) throw new SkildError("INVALID_SOURCE", "Missing alias.");
+  const url = new URL(`${registryUrl}/resolve`);
+  url.searchParams.set("alias", a);
+  const res = await fetchWithTimeout(url.toString(), { headers: { accept: "application/json" } }, 1e4);
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new SkildError("REGISTRY_RESOLVE_FAILED", `Failed to resolve alias "${a}" (${res.status}). ${text}`.trim());
+  }
+  const json = await res.json();
+  if (!json?.ok || !json.type || typeof json.spec !== "string" || !json.spec.trim()) {
+    throw new SkildError("REGISTRY_RESOLVE_FAILED", `Invalid registry response for alias "${a}".`);
+  }
+  if (json.type === "registry") return { type: "registry", spec: json.spec.trim() };
+  if (json.type === "linked") return { type: "linked", spec: json.spec.trim() };
+  throw new SkildError("REGISTRY_RESOLVE_FAILED", `Unsupported alias target type "${json.type}".`);
+}
 async function downloadAndExtractTarball(resolved, tempRoot, stagingDir) {
   const res = await fetchWithTimeout(resolved.tarballUrl, {}, 3e4);
   if (!res.ok) {
@@ -1079,6 +1097,7 @@ export {
   loadOrCreateGlobalConfig,
   loadRegistryAuth,
   parseRegistrySpecifier,
+  resolveRegistryAlias,
   resolveRegistryUrl,
   resolveRegistryVersion,
   saveRegistryAuth,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skild/core",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "Skild core library (headless) for installing, validating, and managing Agent Skills locally.",
   "type": "module",
   "main": "./dist/index.js",