@akira-tl/forgerelay 0.5.6 → 0.6.0

package/dist/skills.js

@@ -3,7 +3,7 @@ import { homedir } from "node:os";
 import { join, resolve, sep } from "node:path";
 import { markAdvertisedFileSourceActivated, resolveAdvertisedFileReadPath, } from "./advertised-files.js";
 import { loadSkills, } from "@earendil-works/pi-coding-agent";
-import { expandHomePath } from "./roots.js";
+import { expandHomePath, isPathInsideRoot } from "./roots.js";
 const SUBAGENT_DELEGATION_NAME = "subagent-delegation";
 export function effectiveSkillPaths(config, cwd) {
     const defaultPathCandidates = [
@@ -46,6 +46,10 @@ export function loadWorkspaceSkills(config, cwd) {
     };
 }
 export function resolveSkillReadPath(skills, activatedSkillDirs, inputPath) {
+    const virtualRead = resolveVirtualSkillReadPath(skills, activatedSkillDirs, inputPath);
+    if (virtualRead)
+        return virtualRead;
+    // Compatibility for stale Host metadata that still contains the historical real path.
     const resolution = resolveAdvertisedFileReadPath(skills, activatedSkillDirs, inputPath);
     if (!resolution)
         return undefined;
@@ -55,6 +59,59 @@ export function resolveSkillReadPath(skills, activatedSkillDirs, inputPath) {
         isSkillFile: resolution.isEntryFile,
     };
 }
+function resolveVirtualSkillReadPath(skills, activatedSkillDirs, inputPath) {
+    const prefix = "skills://";
+    if (!inputPath.startsWith(prefix))
+        return undefined;
+    const requested = inputPath.slice(prefix.length);
+    const slashIndex = requested.indexOf("/");
+    const encodedName = slashIndex === -1 ? requested : requested.slice(0, slashIndex);
+    if (!encodedName)
+        throw new Error(`Invalid skill URI: ${inputPath}`);
+    let name;
+    try {
+        name = decodeURIComponent(encodedName);
+    }
+    catch {
+        throw new Error(`Invalid skill URI: ${inputPath}`);
+    }
+    const skill = skills.find((candidate) => candidate.name === name);
+    if (!skill)
+        throw new Error(`Unknown advertised skill: ${name}`);
+    if (slashIndex === -1 || slashIndex === requested.length - 1) {
+        return {
+            absolutePath: resolve(skill.filePath),
+            skill,
+            isSkillFile: true,
+        };
+    }
+    const relativePart = requested.slice(slashIndex + 1);
+    const segments = relativePart.split("/").map((segment) => {
+        let decoded;
+        try {
+            decoded = decodeURIComponent(segment);
+        }
+        catch {
+            throw new Error(`Invalid skill URI: ${inputPath}`);
+        }
+        if (!decoded || decoded === "." || decoded === ".." || decoded.includes("/") || decoded.includes("\\")) {
+            throw new Error(`Invalid skill URI: ${inputPath}`);
+        }
+        return decoded;
+    });
+    const baseDir = resolve(skill.baseDir);
+    if (!activatedSkillDirs.has(baseDir))
+        return undefined;
+    const absolutePath = resolve(baseDir, ...segments);
+    if (!isPathInsideRoot(absolutePath, baseDir)) {
+        throw new Error(`Skill resource is outside its skill directory: ${inputPath}`);
+    }
+    return {
+        absolutePath,
+        skill,
+        isSkillFile: false,
+    };
+}
 export function markSkillActivated(activatedSkillDirs, skill) {
     markAdvertisedFileSourceActivated(activatedSkillDirs, skill);
 }