codexgpt 1.0.0

package/dist/guidance/skillDiscovery.js

@@ -0,0 +1,353 @@
+import fs from "node:fs";
+import fsp from "node:fs/promises";
+import path from "node:path";
+import os from "node:os";
+import { createHash } from "node:crypto";
+import { isSubpath, normalizeRelPath } from "../guard.js";
+import { normalizeGuidancePathInput, readGuidanceText } from "./safeTextReader.js";
+import { parseSkillMetadata } from "./skillMetadata.js";
+import { parseOpenAISkillMetadata } from "./openaiSkillMetadata.js";
+import { redactSensitiveText } from "../redact.js";
+function skillDiagnostic(code, candidatePath, count = 1) {
+    const actions = {
+        SKILL_METADATA_INVALID: "Fix the Skill frontmatter or remove the invalid candidate.",
+        SKILL_SCAN_TRUNCATED: "Reduce Skill candidates or raise the bounded candidate limit.",
+        SKILL_RESULTS_TRUNCATED: "Use a narrower target or raise the bounded returned-Skill limit.",
+        SKILL_PATH_REDACTED: "Rename the Skill path so it does not resemble a credential."
+    };
+    return {
+        status: "warning",
+        code,
+        path: candidatePath === null ? null : redactSensitiveText(candidatePath),
+        count,
+        action: actions[code]
+    };
+}
+async function targetDirectory(root, targetPath) {
+    const requestedTargetPath = targetPath || ".";
+    if (redactSensitiveText(requestedTargetPath) !== requestedTargetPath)
+        throw new Error("Target is blocked by safety rules.");
+    const normalizedTargetPath = normalizeGuidancePathInput(requestedTargetPath);
+    const requested = path.resolve(root, normalizedTargetPath);
+    if (!isSubpath(requested, root))
+        throw new Error("Target escapes workspace.");
+    try {
+        const real = await fsp.realpath(requested);
+        if (!isSubpath(real, root))
+            throw new Error("Target resolves outside workspace.");
+        const stat = await fsp.stat(real);
+        return stat.isDirectory() ? real : path.dirname(real);
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes("outside"))
+            throw error;
+        let current = path.dirname(requested);
+        while (!fs.existsSync(current)) {
+            const parent = path.dirname(current);
+            if (parent === current)
+                break;
+            current = parent;
+        }
+        const real = await fsp.realpath(current);
+        if (!isSubpath(real, root))
+            throw new Error("Target parent resolves outside workspace.");
+        return (await fsp.stat(real)).isDirectory() ? real : path.dirname(real);
+    }
+}
+function ancestors(root, targetDir) {
+    const result = [];
+    let current = targetDir;
+    while (isSubpath(current, root)) {
+        result.push(current);
+        if (current === root)
+            break;
+        current = path.dirname(current);
+    }
+    return result;
+}
+function selector(root, absPath) {
+    return `$WORKSPACE/${normalizeRelPath(path.relative(root, absPath))}`;
+}
+async function boundedDirents(directory, limit) {
+    const entries = [];
+    let handle;
+    try {
+        handle = await fsp.opendir(directory);
+        for await (const entry of handle) {
+            if (entries.length >= Math.max(1, limit))
+                return { entries, truncated: true };
+            entries.push(entry);
+        }
+        return { entries, truncated: false };
+    }
+    catch {
+        return { entries: [], truncated: false };
+    }
+    finally {
+        await handle?.close().catch(() => undefined);
+    }
+}
+async function readRecord(root, skillFile, proximity, blockedGlobs, identity) {
+    const loaded = await readGuidanceText({ root, relativePath: path.relative(root, skillFile), maxBytes: 100_000, blockedGlobs });
+    if (!loaded.ok)
+        return null;
+    const parsed = parseSkillMetadata(loaded.text, { directoryName: path.basename(path.dirname(skillFile)) });
+    if (!parsed.ok)
+        return null;
+    let companion = { implicitInvocation: true, requirementsState: "none" };
+    const companionPath = path.join(path.dirname(skillFile), "agents", "openai.yaml");
+    if (fs.existsSync(companionPath)) {
+        const companionLoaded = await readGuidanceText({ root, relativePath: path.relative(root, companionPath), maxBytes: 16_384, blockedGlobs });
+        if (!companionLoaded.ok)
+            return null;
+        const parsedCompanion = parseOpenAISkillMetadata(companionLoaded.text);
+        if (!parsedCompanion)
+            return null;
+        companion = parsedCompanion;
+    }
+    return {
+        name: parsed.metadata.name,
+        description: parsed.metadata.description,
+        source: identity?.source ?? "workspace",
+        path: identity?.path ?? selector(root, skillFile),
+        compatibility: parsed.metadata.compatibility ?? null,
+        loadable: true,
+        implicitInvocation: companion.implicitInvocation,
+        requirementsState: companion.requirementsState,
+        implicitEligible: companion.implicitInvocation && companion.requirementsState === "none",
+        specCompliant: parsed.specCompliant,
+        legacyParse: parsed.legacyParse,
+        metadataRedacted: parsed.metadataRedacted,
+        proximity,
+        warnings: parsed.warnings,
+        absPath: skillFile,
+        root
+    };
+}
+async function collectSkillFiles(root, maxCandidates, maxDepth) {
+    const files = [];
+    let truncated = false;
+    let inspected = 0;
+    async function walk(directory, depth) {
+        if (depth < 0 || truncated)
+            return;
+        const remaining = Math.max(1, maxCandidates - inspected);
+        const bounded = await boundedDirents(directory, remaining);
+        const entries = bounded.entries;
+        if (bounded.truncated)
+            truncated = true;
+        entries.sort((left, right) => left.name.localeCompare(right.name));
+        for (const entry of entries) {
+            if (inspected >= maxCandidates) {
+                truncated = true;
+                return;
+            }
+            inspected += 1;
+            const abs = path.join(directory, entry.name);
+            if (entry.isFile() && entry.name === "SKILL.md")
+                files.push(abs);
+            else if (entry.isDirectory() || entry.isSymbolicLink())
+                await walk(abs, depth - 1);
+            if (truncated)
+                return;
+        }
+    }
+    await walk(root, maxDepth);
+    return { files, truncated };
+}
+function rootId(root) {
+    return `root_${createHash("sha256").update(root).digest("hex").slice(0, 16)}`;
+}
+const SOURCE_RANK = {
+    workspace: 0,
+    user: 1,
+    plugin: 2,
+    other: 3
+};
+export async function discoverExplicitGlobalSkills(options) {
+    const configuredCodexDir = fs.existsSync(options.codexDir)
+        ? fs.realpathSync.native(options.codexDir)
+        : path.resolve(options.codexDir);
+    const candidates = [];
+    let scanTruncated = false;
+    const roots = [
+        { root: path.join(configuredCodexDir, "skills"), source: "user", prefix: "$CODEX_DIR/skills", depth: 4 },
+        { root: path.join(os.homedir(), ".agents", "skills"), source: "user", prefix: "$USER_SKILLS", depth: 2 },
+        { root: path.join(configuredCodexDir, "plugins", "cache"), source: "plugin", prefix: "", depth: 10 }
+    ];
+    for (const item of roots) {
+        if (!fs.existsSync(item.root))
+            continue;
+        const realRoot = fs.realpathSync.native(item.root);
+        const remaining = Math.max(1, options.maxCandidates - candidates.length);
+        const found = await collectSkillFiles(realRoot, remaining, item.depth);
+        for (const file of found.files) {
+            const relative = normalizeRelPath(path.relative(realRoot, file));
+            candidates.push({
+                file,
+                root: realRoot,
+                source: item.source,
+                publicPath: item.source === "plugin"
+                    ? `$PLUGIN_ROOT/${rootId(realRoot)}/${relative}`
+                    : `${item.prefix}/${relative}`
+            });
+        }
+        scanTruncated ||= found.truncated;
+        if (candidates.length >= options.maxCandidates) {
+            scanTruncated = true;
+            break;
+        }
+    }
+    const valid = [];
+    let invalidCount = 0;
+    const diagnostics = [];
+    for (const candidate of candidates) {
+        if (redactSensitiveText(candidate.publicPath) !== candidate.publicPath) {
+            invalidCount += 1;
+            diagnostics.push(skillDiagnostic("SKILL_PATH_REDACTED", candidate.publicPath));
+            continue;
+        }
+        const record = await readRecord(candidate.root, candidate.file, 0, options.blockedGlobs, { source: candidate.source, path: candidate.publicPath });
+        if (record)
+            valid.push(record);
+        else {
+            invalidCount += 1;
+            diagnostics.push(skillDiagnostic("SKILL_METADATA_INVALID", candidate.publicPath));
+        }
+    }
+    valid.sort((left, right) => SOURCE_RANK[left.source] - SOURCE_RANK[right.source] || left.name.localeCompare(right.name) || left.path.localeCompare(right.path));
+    const returnedTruncated = valid.length > options.maxSkills;
+    if (scanTruncated)
+        diagnostics.push(skillDiagnostic("SKILL_SCAN_TRUNCATED", null));
+    if (returnedTruncated)
+        diagnostics.push(skillDiagnostic("SKILL_RESULTS_TRUNCATED", null, valid.length - options.maxSkills));
+    return {
+        skills: valid.slice(0, options.maxSkills),
+        candidateCount: candidates.length,
+        validCount: valid.length,
+        invalidCount,
+        scanComplete: !scanTruncated,
+        scanTruncated,
+        returnedTruncated,
+        diagnostics
+    };
+}
+export async function resolveExactGlobalSkill(options) {
+    if (redactSensitiveText(options.selector) !== options.selector)
+        throw new Error("Unsafe global Skill selector.");
+    const configuredCodexDir = fs.existsSync(options.codexDir) ? fs.realpathSync.native(options.codexDir) : path.resolve(options.codexDir);
+    let root;
+    let relative;
+    let source;
+    if (options.selector.startsWith("$CODEX_DIR/skills/")) {
+        root = fs.realpathSync.native(path.join(configuredCodexDir, "skills"));
+        relative = options.selector.slice("$CODEX_DIR/skills/".length);
+        source = "user";
+    }
+    else if (options.selector.startsWith("$USER_SKILLS/")) {
+        root = fs.realpathSync.native(path.join(os.homedir(), ".agents", "skills"));
+        relative = options.selector.slice("$USER_SKILLS/".length);
+        source = "user";
+    }
+    else {
+        const pluginRoot = fs.realpathSync.native(path.join(configuredCodexDir, "plugins", "cache"));
+        const prefix = `$PLUGIN_ROOT/${rootId(pluginRoot)}/`;
+        if (!options.selector.startsWith(prefix))
+            throw new Error("Unknown configured global Skill root.");
+        root = pluginRoot;
+        relative = options.selector.slice(prefix.length);
+        source = "plugin";
+    }
+    const normalized = relative.replace(/\\/g, "/");
+    if (!normalized || path.posix.normalize(normalized) !== normalized || normalized.startsWith("../") || !normalized.endsWith("/SKILL.md"))
+        throw new Error("Unsafe global Skill selector.");
+    const abs = path.resolve(root, ...normalized.split("/"));
+    if (!isSubpath(abs, root))
+        throw new Error("Global Skill boundary violation.");
+    const record = await readRecord(root, abs, 0, options.blockedGlobs, { source, path: options.selector });
+    if (!record)
+        throw new Error("Global Skill unavailable.");
+    return record;
+}
+export async function discoverTargetSkills(options) {
+    const root = fs.realpathSync.native(path.resolve(options.root));
+    const targetDir = await targetDirectory(root, options.targetPath);
+    const candidates = [];
+    let scanTruncated = false;
+    for (const [proximity, directory] of ancestors(root, targetDir).entries()) {
+        const skillsDir = path.join(directory, ".agents", "skills");
+        const remaining = Math.max(1, options.maxCandidates - candidates.length);
+        const bounded = await boundedDirents(skillsDir, remaining);
+        const entries = bounded.entries;
+        scanTruncated ||= bounded.truncated;
+        entries.sort((left, right) => left.name.localeCompare(right.name));
+        for (const entry of entries) {
+            if (candidates.length >= Math.max(1, options.maxCandidates)) {
+                scanTruncated = true;
+                break;
+            }
+            const possible = path.join(skillsDir, entry.name, "SKILL.md");
+            candidates.push({ file: possible, proximity });
+        }
+        if (scanTruncated)
+            break;
+    }
+    const valid = [];
+    let invalidCount = 0;
+    const diagnostics = [];
+    for (const candidate of candidates) {
+        const publicPath = selector(root, candidate.file);
+        if (redactSensitiveText(publicPath) !== publicPath) {
+            invalidCount += 1;
+            diagnostics.push(skillDiagnostic("SKILL_PATH_REDACTED", publicPath));
+            continue;
+        }
+        const record = await readRecord(root, candidate.file, candidate.proximity, options.blockedGlobs);
+        if (record)
+            valid.push(record);
+        else {
+            invalidCount += 1;
+            diagnostics.push(skillDiagnostic("SKILL_METADATA_INVALID", publicPath));
+        }
+    }
+    valid.sort((left, right) => left.proximity - right.proximity || left.name.localeCompare(right.name) || left.path.localeCompare(right.path));
+    const maxSkills = Math.max(1, options.maxSkills);
+    const returnedTruncated = valid.length > maxSkills;
+    if (scanTruncated)
+        diagnostics.push(skillDiagnostic("SKILL_SCAN_TRUNCATED", null));
+    if (returnedTruncated)
+        diagnostics.push(skillDiagnostic("SKILL_RESULTS_TRUNCATED", null, valid.length - maxSkills));
+    return {
+        skills: valid.slice(0, maxSkills),
+        candidateCount: candidates.length,
+        validCount: valid.length,
+        invalidCount,
+        scanComplete: !scanTruncated,
+        scanTruncated,
+        returnedTruncated,
+        diagnostics
+    };
+}
+export async function resolveExactWorkspaceSkill(options) {
+    if (redactSensitiveText(options.selector) !== options.selector)
+        throw new Error("Unsafe Skill selector.");
+    if (!options.selector.startsWith("$WORKSPACE/"))
+        throw new Error("Standard workspace selector required.");
+    const relative = options.selector.slice("$WORKSPACE/".length).replace(/\\/g, "/");
+    if (!relative || path.posix.normalize(relative) !== relative || path.posix.isAbsolute(relative) || relative.startsWith("../"))
+        throw new Error("Unsafe Skill selector.");
+    const root = fs.realpathSync.native(path.resolve(options.root));
+    const targetDir = await targetDirectory(root, options.targetPath);
+    const abs = path.resolve(root, relative);
+    if (path.basename(abs) !== "SKILL.md" || !isSubpath(abs, root))
+        throw new Error("Skill selector boundary violation.");
+    const scopeRoots = ancestors(root, targetDir).map((directory) => path.join(directory, ".agents", "skills"));
+    if (!scopeRoots.some((scopeRoot) => isSubpath(abs, scopeRoot)))
+        throw new Error("Skill is outside the target scope.");
+    const proximity = scopeRoots.findIndex((scopeRoot) => isSubpath(abs, scopeRoot));
+    const record = await readRecord(root, abs, proximity, options.blockedGlobs);
+    if (!record)
+        throw new Error("Skill metadata is unavailable.");
+    return record;
+}
+//# sourceMappingURL=skillDiscovery.js.map

package/dist/guidance/skillDiscovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillDiscovery.js","sourceRoot":"","sources":["../../src/guidance/skillDiscovery.ts"],"names":[],"mappings":"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"}

package/dist/guidance/skillMetadata.js

@@ -0,0 +1,115 @@
+import { parseDocument } from "yaml";
+import { redactSensitiveText } from "../redact.js";
+const MAX_FRONTMATTER_BYTES = 16_384;
+const MAX_NAME_CHARS = 240;
+const MAX_DESCRIPTION_CHARS = 4_000;
+const MAX_OPTIONAL_CHARS = 1_000;
+const MAX_DEPTH = 8;
+const SAFE_NAME = /^[A-Za-z0-9_-]+$/;
+const SPEC_NAME = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+function frontmatter(text) {
+    const source = text.startsWith("\ufeff") ? text.slice(1) : text;
+    if (!source.startsWith("---\n") && !source.startsWith("---\r\n"))
+        return null;
+    const match = source.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/);
+    return match?.[1] ?? null;
+}
+function depth(value, current = 0) {
+    if (current > MAX_DEPTH)
+        return current;
+    if (!value || typeof value !== "object")
+        return current;
+    let maximum = current + 1;
+    const children = Array.isArray(value)
+        ? value
+        : Object.values(value);
+    for (const child of children)
+        maximum = Math.max(maximum, depth(child, current + 1));
+    return maximum;
+}
+function boundedString(value, max) {
+    if (typeof value !== "string")
+        return undefined;
+    const normalized = value.replace(/[\r\n\t]+/g, " ").replace(/\s+/g, " ").trim();
+    if (!normalized || normalized.length > max || /[\u0000-\u001f\u007f]/.test(normalized))
+        return undefined;
+    return normalized;
+}
+function sanitize(value) {
+    const safe = redactSensitiveText(value);
+    return { value: safe, redacted: safe !== value };
+}
+export function parseSkillMetadata(text, options) {
+    const source = frontmatter(text);
+    if (source === null || Buffer.byteLength(source, "utf8") > MAX_FRONTMATTER_BYTES) {
+        return { ok: false, code: "SKILL_METADATA_INVALID", warnings: [] };
+    }
+    let value;
+    try {
+        const document = parseDocument(source, {
+            schema: "core",
+            customTags: [],
+            strict: true,
+            uniqueKeys: true
+        });
+        if (document.errors.length > 0 || document.warnings.some((warning) => warning.code === "TAG_RESOLVE_FAILED")) {
+            return { ok: false, code: "SKILL_METADATA_INVALID", warnings: [] };
+        }
+        value = document.toJS({ maxAliasCount: 0 });
+    }
+    catch {
+        return { ok: false, code: "SKILL_METADATA_INVALID", warnings: [] };
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value) || depth(value) > MAX_DEPTH) {
+        return { ok: false, code: "SKILL_METADATA_INVALID", warnings: [] };
+    }
+    const raw = value;
+    const rawName = boundedString(raw.name, MAX_NAME_CHARS);
+    const rawDescription = boundedString(raw.description, MAX_DESCRIPTION_CHARS);
+    if (!rawName || !rawDescription || !SAFE_NAME.test(rawName)) {
+        return { ok: false, code: "SKILL_METADATA_INVALID", warnings: [] };
+    }
+    const warnings = [];
+    const specCompliant = rawName.length <= 64 && SPEC_NAME.test(rawName) && rawName === options.directoryName;
+    if (!specCompliant)
+        warnings.push("SKILL_METADATA_COMPATIBILITY_WARNING");
+    const name = sanitize(rawName);
+    const description = sanitize(rawDescription);
+    let metadataRedacted = name.redacted || description.redacted;
+    const metadata = { name: name.value, description: description.value };
+    for (const [inputKey, outputKey] of [["license", "license"], ["compatibility", "compatibility"], ["allowed-tools", "allowedTools"]]) {
+        if (!(inputKey in raw))
+            continue;
+        const item = boundedString(raw[inputKey], MAX_OPTIONAL_CHARS);
+        if (!item) {
+            warnings.push("SKILL_METADATA_COMPATIBILITY_WARNING");
+            continue;
+        }
+        const sanitized = sanitize(item);
+        metadataRedacted ||= sanitized.redacted;
+        metadata[outputKey] = sanitized.value;
+    }
+    if ("metadata" in raw) {
+        if (!raw.metadata || typeof raw.metadata !== "object" || Array.isArray(raw.metadata)) {
+            warnings.push("SKILL_METADATA_COMPATIBILITY_WARNING");
+        }
+        else {
+            const entries = Object.entries(raw.metadata);
+            if (entries.length > 32 || entries.some(([key, item]) => !boundedString(key, 120) || !boundedString(item, 500))) {
+                warnings.push("SKILL_METADATA_COMPATIBILITY_WARNING");
+            }
+            else {
+                metadata.metadata = Object.fromEntries(entries.map(([key, item]) => [key, String(item)]));
+            }
+        }
+    }
+    return {
+        ok: true,
+        metadata,
+        metadataRedacted,
+        specCompliant,
+        legacyParse: options.legacy === true,
+        warnings: [...new Set(warnings)]
+    };
+}
+//# sourceMappingURL=skillMetadata.js.map

package/dist/guidance/skillMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillMetadata.js","sourceRoot":"","sources":["../../src/guidance/skillMetadata.ts"],"names":[],"mappings":"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"}

package/dist/guidance/skillResources.js

@@ -0,0 +1,146 @@
+import fs from "node:fs";
+import fsp from "node:fs/promises";
+import path from "node:path";
+import { isSubpath, normalizeRelPath, PathGuard } from "../guard.js";
+import { readGuidanceText } from "./safeTextReader.js";
+import { redactSensitiveText } from "../redact.js";
+const RESOURCE_DIRS = ["references", "scripts", "assets"];
+export function normalizeSkillResourcePath(input) {
+    const normalized = input.replace(/\\/g, "/").replace(/\/{2,}/g, "/").replace(/^(?:\.\/)+/, "");
+    if (!normalized || normalized.trim() !== normalized || normalized.startsWith("/") || /^[A-Za-z]:/.test(normalized) || normalized.includes(":") || /[\u0000-\u001f\u007f]/.test(normalized)) {
+        throw new Error("SKILL_RESOURCE_BOUNDARY_VIOLATION");
+    }
+    const segments = normalized.split("/");
+    if (segments.some((segment) => !segment || segment === "." || segment === ".." || segment.endsWith(".") || segment.endsWith(" "))) {
+        throw new Error("SKILL_RESOURCE_BOUNDARY_VIOLATION");
+    }
+    return segments.join("/");
+}
+function validatedRoots(rootInput, skillRootInput) {
+    const root = fs.realpathSync.native(path.resolve(rootInput));
+    const skillRoot = fs.realpathSync.native(path.resolve(skillRootInput));
+    if (!isSubpath(skillRoot, root))
+        throw new Error("SKILL_RESOURCE_BOUNDARY_VIOLATION");
+    return { root, skillRoot };
+}
+export async function loadSkillResource(options) {
+    const { root, skillRoot } = validatedRoots(options.root, options.skillRoot);
+    const resourcePath = normalizeSkillResourcePath(options.resourcePath);
+    if (redactSensitiveText(resourcePath) !== resourcePath)
+        throw new Error("SKILL_RESOURCE_BLOCKED");
+    const abs = path.resolve(skillRoot, ...resourcePath.split("/"));
+    if (!isSubpath(abs, skillRoot))
+        throw new Error("SKILL_RESOURCE_BOUNDARY_VIOLATION");
+    const relativeRootPath = normalizeRelPath(path.relative(root, abs));
+    const guard = new PathGuard({ blockedGlobs: options.blockedGlobs });
+    if (guard.isBlockedRelativePath(relativeRootPath) || guard.isBlockedRelativePath(resourcePath)) {
+        throw new Error("SKILL_RESOURCE_BLOCKED");
+    }
+    const loaded = await readGuidanceText({ root, relativePath: relativeRootPath, maxBytes: options.maxBytes, blockedGlobs: options.blockedGlobs });
+    if (!loaded.ok) {
+        const code = loaded.reason === "READ_BLOCKED"
+            ? "SKILL_RESOURCE_BLOCKED"
+            : loaded.reason === "READ_BOUNDARY_VIOLATION" || loaded.reason === "READ_IDENTITY_CHANGED"
+                ? "SKILL_RESOURCE_BOUNDARY_VIOLATION"
+                : loaded.reason === "READ_NOT_TEXT" || loaded.reason === "READ_NOT_REGULAR"
+                    ? "SKILL_RESOURCE_NOT_TEXT"
+                    : loaded.reason === "READ_HARDLINK_UNSAFE"
+                        ? "SKILL_RESOURCE_HARDLINK_UNSAFE"
+                        : "SKILL_RESOURCE_READ_FAILED";
+        throw new Error(code);
+    }
+    const currentReal = await fsp.realpath(abs);
+    if (!isSubpath(currentReal, skillRoot))
+        throw new Error("SKILL_RESOURCE_BOUNDARY_VIOLATION");
+    return { path: resourcePath, text: loaded.text, sourceBytes: loaded.sourceBytes, returnedBytes: loaded.returnedBytes };
+}
+export async function indexSkillResources(options) {
+    const { root, skillRoot } = validatedRoots(options.root, options.skillRoot);
+    const guard = new PathGuard({ blockedGlobs: options.blockedGlobs });
+    const limit = Math.max(1, Math.floor(options.maxEntries));
+    const paths = [];
+    let truncated = false;
+    const visitedDirectories = new Set();
+    let inspectedDirectories = 0;
+    let inspectedEntries = 0;
+    const maxDirectories = Math.max(16, limit * 8);
+    const maxEntriesInspected = Math.max(32, limit * 16);
+    async function walk(directory, prefix) {
+        let canonicalDirectory;
+        try {
+            canonicalDirectory = await fsp.realpath(directory);
+        }
+        catch {
+            return;
+        }
+        const directoryKey = process.platform === "win32" ? canonicalDirectory.toLocaleLowerCase("en-US") : canonicalDirectory;
+        if (visitedDirectories.has(directoryKey))
+            return;
+        if (inspectedDirectories >= maxDirectories) {
+            truncated = true;
+            return;
+        }
+        visitedDirectories.add(directoryKey);
+        inspectedDirectories += 1;
+        const entries = [];
+        let handle;
+        try {
+            handle = await fsp.opendir(canonicalDirectory);
+            for await (const entry of handle) {
+                if (inspectedEntries >= maxEntriesInspected) {
+                    truncated = true;
+                    break;
+                }
+                inspectedEntries += 1;
+                entries.push(entry);
+            }
+        }
+        catch {
+            return;
+        }
+        finally {
+            await handle?.close().catch(() => undefined);
+        }
+        entries.sort((left, right) => left.name.localeCompare(right.name));
+        for (const entry of entries) {
+            if (paths.length >= limit) {
+                truncated = true;
+                return;
+            }
+            const relative = `${prefix}/${entry.name}`;
+            if (guard.isBlockedRelativePath(relative))
+                continue;
+            if (redactSensitiveText(relative) !== relative)
+                continue;
+            const abs = path.join(canonicalDirectory, entry.name);
+            let real;
+            try {
+                real = await fsp.realpath(abs);
+            }
+            catch {
+                continue;
+            }
+            if (!isSubpath(real, skillRoot) || !isSubpath(real, root))
+                continue;
+            const workspaceRelative = normalizeRelPath(path.relative(root, real));
+            if (guard.isBlockedRelativePath(workspaceRelative))
+                continue;
+            const stat = await fsp.stat(real).catch(() => null);
+            if (!stat)
+                continue;
+            if (stat.isDirectory())
+                await walk(real, relative);
+            else if (stat.isFile())
+                paths.push(relative);
+            if (truncated)
+                return;
+        }
+    }
+    for (const name of RESOURCE_DIRS) {
+        await walk(path.join(skillRoot, name), name);
+        if (truncated)
+            break;
+    }
+    return { paths, truncated };
+}
+//# sourceMappingURL=skillResources.js.map