ctx7 0.3.11 → 0.3.13

package/dist/index.js

@@ -844,7 +844,7 @@ async function installSkillFiles(skillName, files, targetDir) {
   const skillDir = resolve(targetDir, skillName);
   for (const file of files) {
     const filePath = resolve(skillDir, file.path);
-    if (!filePath.startsWith(skillDir + "/") && filePath !== skillDir) {
+    if (!filePath.startsWith(skillDir + "/") && !filePath.startsWith(skillDir + "\\") && filePath !== skillDir) {
       throw new Error(`Skill file path "${file.path}" resolves outside the target directory`);
     }
     const fileDir = dirname3(filePath);
@@ -2785,6 +2785,7 @@ alwaysApply: true
 ---
 
 `;
+var CODEX_CLI_SANDBOX_GUIDANCE = `Run Context7 CLI requests outside Codex's default sandbox. If a Context7 CLI command fails with DNS or network errors such as ENOTFOUND, host resolution failures, or fetch failed, rerun it outside the sandbox instead of retrying inside the sandbox.`;
 async function fetchRule(filename, fallback) {
   for (const base of GITHUB_RAW_URLS) {
     try {
@@ -2798,9 +2799,40 @@ async function fetchRule(filename, fallback) {
 }
 async function getRuleContent(mode, agent) {
   const [filename, fallback] = mode === "mcp" ? ["context7-mcp.md", FALLBACK_MCP] : ["context7-cli.md", FALLBACK_CLI];
-  const body = await fetchRule(filename, fallback);
+  let body = await fetchRule(filename, fallback);
+  if (mode === "cli" && agent === "codex" && !body.includes(CODEX_CLI_SANDBOX_GUIDANCE)) {
+    body = `${body.trimEnd()}
+${CODEX_CLI_SANDBOX_GUIDANCE}
+`;
+  }
   return agent === "cursor" ? `${CURSOR_FRONTMATTER}${body}` : body;
 }
+function customizeSkillFilesForAgent(agent, skillName, files) {
+  if (agent !== "codex" || skillName !== "find-docs") {
+    return files;
+  }
+  return files.map((file) => {
+    if (file.path !== "SKILL.md" || file.content.includes(CODEX_CLI_SANDBOX_GUIDANCE)) {
+      return file;
+    }
+    const marker = "## Step 1: Resolve a Library";
+    const guidance = `${CODEX_CLI_SANDBOX_GUIDANCE}
+
+`;
+    if (file.content.includes(marker)) {
+      return {
+        ...file,
+        content: file.content.replace(marker, `${guidance}${marker}`)
+      };
+    }
+    const separator = file.content.endsWith("\n") ? "\n" : "\n\n";
+    return {
+      ...file,
+      content: `${file.content}${separator}${CODEX_CLI_SANDBOX_GUIDANCE}
+`
+    };
+  });
+}
 
 // src/setup/mcp-writer.ts
 import { access as access3, readFile as readFile3, writeFile as writeFile3, mkdir as mkdir3 } from "fs/promises";
@@ -3184,7 +3216,8 @@ async function setupCliAgent(agentName, scope, downloadData) {
   const skillDir = scope === "global" ? agent.skill.dir("global") : join9(process.cwd(), agent.skill.dir("project"));
   let skillStatus;
   try {
-    await installSkillFiles("find-docs", downloadData.files, skillDir);
+    const files = customizeSkillFilesForAgent(agentName, "find-docs", downloadData.files);
+    await installSkillFiles("find-docs", files, skillDir);
     skillStatus = "installed";
   } catch (err) {
     skillStatus = `failed: ${err instanceof Error ? err.message : String(err)}`;