@skild/core 0.4.0 → 0.4.1

package/dist/index.d.ts

@@ -158,6 +158,15 @@ declare function materializeSourceToTemp(source: string): Promise<{
     sourceType: SourceType;
 }>;
 
+declare function toDegitPath(url: string): string;
+/**
+ * Derive a child source spec from a base source and a relative path.
+ *
+ * - GitHub URLs are converted to degit shorthand so the result is a valid install source.
+ * - Keeps `#ref` when present.
+ */
+declare function deriveChildSource(baseSource: string, relPath: string): string;
+
 declare const DEFAULT_REGISTRY_URL = "https://registry.skild.sh";
 interface RegistrySpecifier {
     canonicalName: string;
@@ -235,4 +244,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, downloadAndExtractTarball, fetchWithTimeout, getSkillInfo, getSkillInstallDir, getSkillsDir, initSkill, installRegistrySkill, installSkill, isValidAlias, listAllSkills, listSkills, loadOrCreateGlobalConfig, loadRegistryAuth, materializeSourceToDir, materializeSourceToTemp, normalizeAlias, parseRegistrySpecifier, resolveRegistryAlias, 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, 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 };

package/dist/index.js

@@ -418,10 +418,26 @@ function toDegitPath(url) {
     const [, owner, repo, branch, subpath] = treeMatch;
     return `${owner}/${repo}/${subpath}#${branch}`;
   }
+  const treeRootMatch = url.match(/github\.com\/([^/]+)\/([^/]+)\/tree\/([^/]+)(?:\/)?$/);
+  if (treeRootMatch) {
+    const [, owner, repo, branch] = treeRootMatch;
+    return `${owner}/${repo}#${branch}`;
+  }
   const repoMatch = url.match(/github\.com\/([^/]+\/[^/]+)/);
   if (repoMatch) return repoMatch[1].replace(/\.git$/, "");
   return url;
 }
+function normalizeRelPath(relPath) {
+  return relPath.split(path6.sep).join("/").replace(/^\/+/, "").replace(/\/+$/, "");
+}
+function deriveChildSource(baseSource, relPath) {
+  const baseType = classifySource(baseSource);
+  const baseSpec = baseType === "github-url" ? toDegitPath(baseSource) : baseSource;
+  const [pathPart, ref] = baseSpec.split("#", 2);
+  const clean = normalizeRelPath(relPath);
+  const joined = clean ? `${pathPart.replace(/\/+$/, "")}/${clean}` : pathPart;
+  return ref ? `${joined}#${ref}` : joined;
+}
 
 // src/materialize.ts
 function ensureInstallableDir(sourcePath) {
@@ -1156,6 +1172,7 @@ export {
   assertValidAlias,
   canonicalNameToInstallDirName,
   clearRegistryAuth,
+  deriveChildSource,
   downloadAndExtractTarball,
   fetchWithTimeout,
   getSkillInfo,
@@ -1179,6 +1196,7 @@ export {
   saveRegistryAuth,
   searchRegistrySkills,
   splitCanonicalName,
+  toDegitPath,
   uninstallSkill,
   updateSkill,
   validateSkill,

package/package.json

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