@skild/core 0.5.0 → 0.5.2

package/dist/index.d.ts

@@ -159,6 +159,7 @@ declare function materializeSourceToTemp(source: string): Promise<{
 }>;
 
 declare function toDegitPath(url: string): string;
+declare function stripSourceRef(source: string): string;
 /**
  * Derive a child source spec from a base source and a relative path.
  *
@@ -244,4 +245,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, assertValidAlias, canonicalNameToInstallDirName, clearRegistryAuth, deriveChildSource, downloadAndExtractTarball, fetchWithTimeout, getSkillInfo, getSkillInstallDir, getSkillsDir, initSkill, installRegistrySkill, installSkill, isValidAlias, listAllSkills, listSkills, loadOrCreateGlobalConfig, loadRegistryAuth, materializeSourceToDir, materializeSourceToTemp, normalizeAlias, parseRegistrySpecifier, resolveRegistryAlias, resolveRegistryUrl, resolveRegistryVersion, saveRegistryAuth, searchRegistrySkills, splitCanonicalName, toDegitPath, 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, assertValidAlias, canonicalNameToInstallDirName, clearRegistryAuth, deriveChildSource, downloadAndExtractTarball, fetchWithTimeout, getSkillInfo, getSkillInstallDir, getSkillsDir, initSkill, installRegistrySkill, installSkill, isValidAlias, listAllSkills, listSkills, loadOrCreateGlobalConfig, loadRegistryAuth, materializeSourceToDir, materializeSourceToTemp, normalizeAlias, parseRegistrySpecifier, resolveRegistryAlias, resolveRegistryUrl, resolveRegistryVersion, saveRegistryAuth, searchRegistrySkills, splitCanonicalName, stripSourceRef, toDegitPath, uninstallSkill, updateSkill, validateSkill, validateSkillDir };

package/dist/index.js

@@ -433,6 +433,11 @@ function toDegitPath(url) {
   if (repoMatch) return repoMatch[1].replace(/\.git$/, "");
   return url;
 }
+function stripSourceRef(source) {
+  const hashIndex = source.indexOf("#");
+  if (hashIndex === -1) return source;
+  return source.slice(0, hashIndex);
+}
 function normalizeRelPath(relPath) {
   return relPath.split(path6.sep).join("/").replace(/^\/+/, "").replace(/\/+$/, "");
 }
@@ -455,6 +460,24 @@ async function cloneRemote(degitSrc, targetPath) {
   const emitter = degit(degitSrc, { force: true, verbose: false });
   await emitter.clone(targetPath);
 }
+function isMissingRefError(error) {
+  if (!error) return false;
+  const message = error instanceof Error ? error.message : String(error);
+  return /could not find commit hash/i.test(message);
+}
+async function cloneRemoteWithFallback(degitSrc, targetPath) {
+  try {
+    await cloneRemote(degitSrc, targetPath);
+    return degitSrc;
+  } catch (error) {
+    if (!degitSrc.includes("#") || !isMissingRefError(error)) {
+      throw error;
+    }
+  }
+  const fallbackSrc = stripSourceRef(degitSrc);
+  await cloneRemote(fallbackSrc, targetPath);
+  return fallbackSrc;
+}
 async function materializeSourceToDir(input) {
   const sourceType = classifySource(input.source);
   const targetDir = path7.resolve(input.targetDir);
@@ -472,8 +495,8 @@ async function materializeSourceToDir(input) {
     return { sourceType: "local", materializedFrom: localPath };
   }
   const degitPath = toDegitPath(input.source);
-  await cloneRemote(degitPath, targetDir);
-  return { sourceType, materializedFrom: degitPath };
+  const materializedFrom = await cloneRemoteWithFallback(degitPath, targetDir);
+  return { sourceType, materializedFrom };
 }
 async function materializeSourceToTemp(source) {
   const sourceType = classifySource(source);
@@ -611,13 +634,22 @@ async function resolveRegistryAlias(registryUrl, alias) {
     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()) {
+  const normalizedSpec = normalizeResolvedSpec(json?.spec);
+  if (!json?.ok || !json.type || !normalizedSpec) {
     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() };
+  if (json.type === "registry") return { type: "registry", spec: normalizedSpec };
+  if (json.type === "linked") return { type: "linked", spec: normalizedSpec };
   throw new SkildError("REGISTRY_RESOLVE_FAILED", `Unsupported alias target type "${json.type}".`);
 }
+function normalizeResolvedSpec(spec) {
+  if (typeof spec !== "string") return "";
+  let normalized = spec.trim();
+  while (normalized.length >= 2 && (normalized.startsWith('"') && normalized.endsWith('"') || normalized.startsWith("'") && normalized.endsWith("'"))) {
+    normalized = normalized.slice(1, -1).trim();
+  }
+  return normalized;
+}
 async function downloadAndExtractTarball(resolved, tempRoot, stagingDir) {
   const res = await fetchWithTimeout(resolved.tarballUrl, {}, 3e4);
   if (!res.ok) {
@@ -1202,6 +1234,7 @@ export {
   saveRegistryAuth,
   searchRegistrySkills,
   splitCanonicalName,
+  stripSourceRef,
   toDegitPath,
   uninstallSkill,
   updateSkill,

package/package.json

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