experimental-ash 0.26.0 → 0.28.0

package/dist/src/discover/filesystem.js

@@ -1,215 +1 @@
-import { sep } from "node:path";
-/**
- * Supported authored JavaScript and TypeScript module file extensions.
- */
-export const SUPPORTED_AUTHORED_MODULE_FILE_EXTENSIONS = [
-    ".cts",
-    ".mts",
-    ".cjs",
-    ".mjs",
-    ".ts",
-    ".js",
-];
-/**
- * Files that mark a surrounding directory as an application root when paired
- * with a top-level `agent/` directory.
- */
-export const PROJECT_MARKER_FILE_NAMES = ["package.json", "vercel.json"];
-const PROJECT_MARKER_FILE_NAME_SET = new Set(PROJECT_MARKER_FILE_NAMES);
-/**
- * Returns the normalized entry type for a Node filesystem dirent.
- */
-export function getDirectoryEntryType(entry) {
-    if (entry.isDirectory()) {
-        return "directory";
-    }
-    if (entry.isFile()) {
-        return "file";
-    }
-    return "other";
-}
-/**
- * Returns whether an entry marks a directory as an app root for nested agents.
- */
-export function isProjectMarkerEntry(name, entryType) {
-    return entryType === "file" && PROJECT_MARKER_FILE_NAME_SET.has(name);
-}
-/**
- * Classifies a top-level agent-root entry according to the spec-legal grammar.
- */
-export function classifyAgentRootEntry(name, entryType) {
-    if (entryType === "file") {
-        if (matchesSupportedModuleBaseName(name, "agent")) {
-            return "agent-config-module";
-        }
-        if (name === "instructions.md") {
-            return "instructions-markdown";
-        }
-        if (matchesSupportedModuleBaseName(name, "instructions")) {
-            return "instructions-module";
-        }
-        if (name === "system.md") {
-            return "system-markdown";
-        }
-        if (matchesSupportedModuleBaseName(name, "system")) {
-            return "system-module";
-        }
-        return "unknown";
-    }
-    if (entryType === "directory") {
-        if (name === "channels") {
-            return "channels-directory";
-        }
-        if (name === "connections") {
-            return "connections-directory";
-        }
-        if (name === "hooks") {
-            return "hooks-directory";
-        }
-        if (name === "lib") {
-            return "lib-directory";
-        }
-        if (name === "skills") {
-            return "skills-directory";
-        }
-        if (name === "sandbox") {
-            return "sandbox-directory";
-        }
-        if (name === "tools") {
-            return "tools-directory";
-        }
-        if (name === "schedules") {
-            return "schedules-directory";
-        }
-        if (name === "subagents") {
-            return "subagents-directory";
-        }
-    }
-    return "unknown";
-}
-/**
- * Classifies a local-subagent package root entry according to the spec-legal grammar.
- */
-export function classifyLocalSubagentEntry(name, entryType) {
-    if (entryType === "file") {
-        if (matchesSupportedModuleBaseName(name, "agent")) {
-            return "agent-config-module";
-        }
-        if (name === "instructions.md") {
-            return "instructions-markdown";
-        }
-        if (matchesSupportedModuleBaseName(name, "instructions")) {
-            return "instructions-module";
-        }
-        if (name === "system.md") {
-            return "system-markdown";
-        }
-        if (matchesSupportedModuleBaseName(name, "system")) {
-            return "system-module";
-        }
-        return "unknown";
-    }
-    if (entryType === "directory") {
-        if (name === "connections") {
-            return "connections-directory";
-        }
-        if (name === "hooks") {
-            return "hooks-directory";
-        }
-        if (name === "lib") {
-            return "lib-directory";
-        }
-        if (name === "sandbox") {
-            return "sandbox-directory";
-        }
-        if (name === "skills") {
-            return "skills-directory";
-        }
-        if (name === "tools") {
-            return "tools-directory";
-        }
-        if (name === "subagents") {
-            return "subagents-directory";
-        }
-        if (name === "schedules") {
-            return "invalid-schedules-directory";
-        }
-    }
-    return "unknown";
-}
-/**
- * Classifies a file or directory inside an Agent Skills package.
- */
-export function classifySkillPackageEntry(name, entryType) {
-    if (entryType === "file") {
-        if (name === "SKILL.md") {
-            return "skill-markdown";
-        }
-        return "skill-resource";
-    }
-    if (entryType === "directory") {
-        if (name === "scripts") {
-            return "skill-scripts-directory";
-        }
-        if (name === "references") {
-            return "skill-references-directory";
-        }
-        if (name === "assets") {
-            return "skill-assets-directory";
-        }
-    }
-    return "skill-resource";
-}
-/**
- * Classifies one top-level entry inside the authored `skills/` directory.
- */
-export function classifySkillsDirectoryEntry(name, entryType) {
-    if (entryType === "directory") {
-        return "skill-package-directory";
-    }
-    if (entryType === "file") {
-        if (name.endsWith(".md")) {
-            return "flat-skill-markdown";
-        }
-        if (getSupportedModuleBaseName(name) !== null) {
-            return "flat-skill-module";
-        }
-    }
-    return "unknown";
-}
-/**
- * Normalizes an agent-root-relative logical path to forward slashes.
- */
-export function normalizeLogicalPath(input) {
-    return input.replaceAll(sep, "/").replace(/^\.\//, "").replace(/^\/+/, "");
-}
-/**
- * Returns the authored module basename when the file uses a supported module
- * extension.
- */
-export function getSupportedModuleBaseName(name) {
-    for (const extension of SUPPORTED_AUTHORED_MODULE_FILE_EXTENSIONS) {
-        if (name.endsWith(extension) && name.length > extension.length) {
-            return name.slice(0, -extension.length);
-        }
-    }
-    return null;
-}
-/**
- * Returns whether the file name matches one supported authored module basename.
- */
-export function matchesSupportedModuleBaseName(name, baseName) {
-    return getSupportedModuleBaseName(name) === baseName;
-}
-/**
- * Removes a final file extension from a logical path when present.
- */
-export function stripLogicalPathExtension(input) {
-    const normalizedPath = normalizeLogicalPath(input);
-    const lastSlashIndex = normalizedPath.lastIndexOf("/");
-    const lastDotIndex = normalizedPath.lastIndexOf(".");
-    if (lastDotIndex === -1 || lastDotIndex < lastSlashIndex) {
-        return normalizedPath;
-    }
-    return normalizedPath.slice(0, lastDotIndex);
-}
+import{sep}from"node:path";var SUPPORTED_AUTHORED_MODULE_FILE_EXTENSIONS=[`.cts`,`.mts`,`.cjs`,`.mjs`,`.ts`,`.js`],PROJECT_MARKER_FILE_NAMES=[`package.json`,`vercel.json`],PROJECT_MARKER_FILE_NAME_SET=new Set(PROJECT_MARKER_FILE_NAMES);function getDirectoryEntryType(e){return e.isDirectory()?`directory`:e.isFile()?`file`:`other`}function isProjectMarkerEntry(e,t){return t===`file`&&PROJECT_MARKER_FILE_NAME_SET.has(e)}function classifyAgentRootEntry(e,t){if(t===`file`)return matchesSupportedModuleBaseName(e,`agent`)?`agent-config-module`:e===`instructions.md`?`instructions-markdown`:matchesSupportedModuleBaseName(e,`instructions`)?`instructions-module`:e===`system.md`?`system-markdown`:matchesSupportedModuleBaseName(e,`system`)?`system-module`:`unknown`;if(t===`directory`){if(e===`channels`)return`channels-directory`;if(e===`connections`)return`connections-directory`;if(e===`hooks`)return`hooks-directory`;if(e===`lib`)return`lib-directory`;if(e===`skills`)return`skills-directory`;if(e===`sandbox`)return`sandbox-directory`;if(e===`tools`)return`tools-directory`;if(e===`schedules`)return`schedules-directory`;if(e===`subagents`)return`subagents-directory`}return`unknown`}function classifyLocalSubagentEntry(e,t){if(t===`file`)return matchesSupportedModuleBaseName(e,`agent`)?`agent-config-module`:e===`instructions.md`?`instructions-markdown`:matchesSupportedModuleBaseName(e,`instructions`)?`instructions-module`:e===`system.md`?`system-markdown`:matchesSupportedModuleBaseName(e,`system`)?`system-module`:`unknown`;if(t===`directory`){if(e===`connections`)return`connections-directory`;if(e===`hooks`)return`hooks-directory`;if(e===`lib`)return`lib-directory`;if(e===`sandbox`)return`sandbox-directory`;if(e===`skills`)return`skills-directory`;if(e===`tools`)return`tools-directory`;if(e===`subagents`)return`subagents-directory`;if(e===`schedules`)return`invalid-schedules-directory`}return`unknown`}function classifySkillPackageEntry(e,t){if(t===`file`)return e===`SKILL.md`?`skill-markdown`:`skill-resource`;if(t===`directory`){if(e===`scripts`)return`skill-scripts-directory`;if(e===`references`)return`skill-references-directory`;if(e===`assets`)return`skill-assets-directory`}return`skill-resource`}function classifySkillsDirectoryEntry(e,t){if(t===`directory`)return`skill-package-directory`;if(t===`file`){if(e.endsWith(`.md`))return`flat-skill-markdown`;if(getSupportedModuleBaseName(e)!==null)return`flat-skill-module`}return`unknown`}function normalizeLogicalPath(t){return t.replaceAll(sep,`/`).replace(/^\.\//,``).replace(/^\/+/,``)}function getSupportedModuleBaseName(e){for(let n of SUPPORTED_AUTHORED_MODULE_FILE_EXTENSIONS)if(e.endsWith(n)&&e.length>n.length)return e.slice(0,-n.length);return null}function matchesSupportedModuleBaseName(e,t){return getSupportedModuleBaseName(e)===t}function stripLogicalPathExtension(e){let t=normalizeLogicalPath(e),n=t.lastIndexOf(`/`),r=t.lastIndexOf(`.`);return r===-1||r<n?t:t.slice(0,r)}export{PROJECT_MARKER_FILE_NAMES,SUPPORTED_AUTHORED_MODULE_FILE_EXTENSIONS,classifyAgentRootEntry,classifyLocalSubagentEntry,classifySkillPackageEntry,classifySkillsDirectoryEntry,getDirectoryEntryType,getSupportedModuleBaseName,isProjectMarkerEntry,matchesSupportedModuleBaseName,normalizeLogicalPath,stripLogicalPathExtension};

package/dist/src/discover/grammar.js

@@ -1,371 +1 @@
-import { join } from "node:path";
-import { lowerInstructionsMarkdown } from "#internal/helpers/markdown.js";
-import { createDiscoverErrorDiagnostic, createDiscoverWarningDiagnostic, } from "#discover/diagnostics.js";
-import { getDirectoryEntryType } from "#discover/filesystem.js";
-import { createModuleSourceRef } from "#discover/manifest.js";
-import { discoverMarkdownSource } from "#discover/markdown.js";
-import { collectFlatSlotCandidates } from "#discover/slots.js";
-/**
- * Shared diagnostic emitted when a slot has multiple authored module sources.
- */
-export const DISCOVER_MODULE_SLOT_COLLISION = "discover/module-slot-collision";
-/**
- * Shared diagnostic emitted when the required instructions prompt source
- * is missing.
- */
-export const DISCOVER_REQUIRED_INSTRUCTIONS_MISSING = "discover/required-instructions-missing";
-/**
- * Shared diagnostic emitted when discovery falls back to the deprecated
- * `system.{md,ts,...}` slot because no `instructions.{md,ts,...}` source
- * was found. The fallback resolves successfully; the warning prompts the
- * author to rename the file.
- */
-export const DISCOVER_DEPRECATED_SYSTEM_SLOT = "discover/deprecated-system-slot";
-/**
- * Shared diagnostic emitted when a slot has both markdown and module sources.
- */
-export const DISCOVER_SLOT_COLLISION = "discover/slot-collision";
-/**
- * Shared diagnostic emitted when the authored `tools/` root is not a
- * directory.
- */
-export const DISCOVER_TOOLS_DIRECTORY_INVALID = "discover/tools-directory-invalid";
-/**
- * Shared diagnostic emitted when the authored `hooks/` root is not a
- * directory.
- */
-export const DISCOVER_HOOKS_DIRECTORY_INVALID = "discover/hooks-directory-invalid";
-/**
- * Shared diagnostic emitted when the authored `channels/` root is not a
- * directory.
- */
-export const DISCOVER_CHANNELS_DIRECTORY_INVALID = "discover/channels-directory-invalid";
-/**
- * Shared diagnostic emitted when an authored `tools/*.{ts,…}` filename does
- * not satisfy the model tool-name charset rule.
- */
-export const DISCOVER_TOOL_NAME_INVALID = "discover/tool-name-invalid";
-/**
- * Shared diagnostic emitted when an authored `connections/*.{ts,…}` filename
- * does not satisfy the connection slug charset rule.
- */
-export const DISCOVER_CONNECTION_NAME_INVALID = "discover/connection-name-invalid";
-/**
- * Shared diagnostic emitted when the authored `sandbox/` root is not a
- * directory. The diagnostic code string retains its plural suffix for
- * stability across manifest versions.
- */
-export const DISCOVER_SANDBOX_DIRECTORY_INVALID = "discover/sandbox-directory-invalid";
-/**
- * Shared diagnostic emitted when an authored `channels/**` filename or
- * directory segment does not satisfy the channel slug charset rule.
- */
-export const DISCOVER_CHANNEL_NAME_INVALID = "discover/channel-name-invalid";
-/**
- * Shared diagnostic emitted when an authored `hooks/**` filename or
- * directory segment does not satisfy the hook slug charset rule.
- */
-export const DISCOVER_HOOK_NAME_INVALID = "discover/hook-name-invalid";
-/**
- * Tool filename charset. The slug must start with an ASCII letter and may
- * contain ASCII letters, digits, underscores, and dashes. The 64-character
- * cap matches the most restrictive provider tool-name limit.
- *
- * The model-facing tool name is the filename slug verbatim — there is no
- * authored `name` override and no compile-time normalization. Authors who
- * want a snake_case identifier should name the file in snake_case.
- */
-export const TOOL_SLUG_PATTERN = /^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/;
-/**
- * Connection filename charset. Connections use the same lowercase
- * kebab-case rule as sandbox since they are not directly exposed to
- * model APIs as identifiers.
- */
-export const CONNECTION_SLUG_PATTERN = /^[a-z][a-z0-9-]{0,63}$/;
-/**
- * Channel filename / directory segment charset.
- */
-export const CHANNEL_SLUG_PATTERN = /^(\.?[a-z][a-z0-9-]{0,63}|\[[a-zA-Z][a-zA-Z0-9_]{0,63}\])$/;
-/**
- * Hook filename / directory segment charset. Each segment of the
- * path-relative slug uses the same restrictive charset as tool slugs:
- * ASCII letters, digits, underscores, and dashes, starting with a
- * letter, up to 64 characters per segment. Bracketed parameter forms
- * are not allowed — hooks have no URL semantics.
- */
-export const HOOK_SLUG_PATTERN = /^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/;
-/**
- * Shared diagnostic emitted when discovery ignores one unsupported directory.
- */
-export const DISCOVER_UNSUPPORTED_DIRECTORY = "discover/unsupported-directory";
-/**
- * Reads one directory through `source` and returns its entries sorted by name.
- */
-export async function readSortedDirectoryEntries(source, directoryPath) {
-    const entries = [...(await source.readDirectory(directoryPath))];
-    entries.sort((left, right) => left.name.localeCompare(right.name));
-    return entries;
-}
-/**
- * Discovers one required `instructions.md|ts|cts|mts|js|cjs|mjs` source
- * from a root directory.
- *
- * For backwards compatibility, falls back to the deprecated
- * `system.{md,ts,...}` slot when no `instructions.*` source is present —
- * with a {@link DISCOVER_DEPRECATED_SYSTEM_SLOT} warning prompting the
- * author to rename the file.
- */
-export async function discoverInstructionsSource(input) {
-    const result = await discoverSlotSource({
-        markdownFileName: "instructions.md",
-        moduleBaseName: "instructions",
-        rootEntries: input.rootEntries,
-        rootPath: input.rootPath,
-        slotLabel: "instructions",
-        source: input.source,
-    });
-    if (result.diagnostics.length > 0 || result.source !== undefined) {
-        return {
-            diagnostics: result.diagnostics,
-            instructions: result.source,
-        };
-    }
-    const legacyResult = await discoverSlotSource({
-        markdownFileName: "system.md",
-        moduleBaseName: "system",
-        rootEntries: input.rootEntries,
-        rootPath: input.rootPath,
-        slotLabel: "system",
-        source: input.source,
-    });
-    if (legacyResult.source !== undefined) {
-        const fileName = legacyResult.source.sourceKind === "markdown" ? "system.md" : legacyResult.source.logicalPath;
-        return {
-            diagnostics: [
-                createDiscoverWarningDiagnostic({
-                    code: DISCOVER_DEPRECATED_SYSTEM_SLOT,
-                    message: `The "${fileName}" slot is deprecated. Rename it to "${fileName.replace(/^system/, "instructions")}" — the runtime still loads the legacy slot for now, but support will be removed in a future release.`,
-                    sourcePath: join(input.rootPath, fileName),
-                }),
-                ...legacyResult.diagnostics,
-            ],
-            instructions: legacyResult.source,
-        };
-    }
-    if (legacyResult.diagnostics.length > 0) {
-        return {
-            diagnostics: legacyResult.diagnostics,
-        };
-    }
-    if (input.required === false) {
-        return {
-            diagnostics: [],
-        };
-    }
-    return {
-        diagnostics: [
-            createDiscoverErrorDiagnostic({
-                code: DISCOVER_REQUIRED_INSTRUCTIONS_MISSING,
-                message: 'Expected one authored instructions prompt source at "instructions.md", "instructions.ts", "instructions.cts", "instructions.mts", "instructions.js", "instructions.cjs", or "instructions.mjs".',
-                sourcePath: input.rootPath,
-            }),
-        ],
-    };
-}
-async function discoverSlotSource(input) {
-    const candidates = collectFlatSlotCandidates(input.rootEntries, {
-        markdownFileName: input.markdownFileName,
-        moduleBaseName: input.moduleBaseName,
-    });
-    if (candidates.markdownFileName !== undefined && candidates.moduleFileNames.length > 0) {
-        return {
-            diagnostics: [
-                createSlotCollisionDiagnostic(input.rootPath, input.slotLabel, [
-                    candidates.markdownFileName,
-                    ...candidates.moduleFileNames,
-                ]),
-            ],
-        };
-    }
-    if (candidates.moduleFileNames.length > 1) {
-        return {
-            diagnostics: [
-                createModuleSlotCollisionDiagnostic(input.rootPath, input.slotLabel, candidates.moduleFileNames),
-            ],
-        };
-    }
-    if (candidates.markdownFileName !== undefined) {
-        return {
-            diagnostics: [],
-            source: await discoverMarkdownSource({
-                logicalPath: input.markdownFileName,
-                lower: lowerInstructionsMarkdown,
-                source: input.source,
-                sourcePath: join(input.rootPath, candidates.markdownFileName),
-            }),
-        };
-    }
-    const [logicalPath] = candidates.moduleFileNames;
-    if (logicalPath !== undefined) {
-        return {
-            diagnostics: [],
-            source: createModuleSourceRef({
-                logicalPath,
-            }),
-        };
-    }
-    return { diagnostics: [] };
-}
-/**
- * Discovers one flat module slot such as `agent.ts` or `subagent.cjs`.
- */
-export function discoverFlatModuleSource(input) {
-    const candidates = collectFlatSlotCandidates(input.rootEntries, {
-        moduleBaseName: input.slotName,
-    });
-    if (candidates.moduleFileNames.length > 1) {
-        return {
-            diagnostics: [
-                createModuleSlotCollisionDiagnostic(input.rootPath, input.slotName, candidates.moduleFileNames),
-            ],
-        };
-    }
-    const [logicalPath] = candidates.moduleFileNames;
-    if (logicalPath !== undefined) {
-        return {
-            diagnostics: [],
-            module: createModuleSourceRef({
-                logicalPath,
-            }),
-        };
-    }
-    if (input.missingDiagnostic === undefined) {
-        return {
-            diagnostics: [],
-        };
-    }
-    return {
-        diagnostics: [
-            createDiscoverErrorDiagnostic({
-                code: input.missingDiagnostic.code,
-                message: input.missingDiagnostic.message,
-                sourcePath: input.rootPath,
-            }),
-        ],
-    };
-}
-/**
- * Returns a discovery diagnostic when a tool slot name violates
- * {@link TOOL_SLUG_PATTERN}, or `null` when it satisfies the rule.
- *
- * Wired in by {@link discoverNamedSourceDirectory} callers via
- * `validateSegment` so the discover layer rejects illegal filenames before
- * the compiler ever loads the module.
- */
-export function createToolNameDiagnostic(slotName, sourcePath) {
-    if (TOOL_SLUG_PATTERN.test(slotName)) {
-        return null;
-    }
-    return createDiscoverErrorDiagnostic({
-        code: DISCOVER_TOOL_NAME_INVALID,
-        message: `Tool filename "${slotName}" is not a legal tool name. ` +
-            `Expected ASCII letters, digits, underscores, and dashes only, starting with a letter, up to 64 characters.`,
-        sourcePath,
-    });
-}
-/**
- * Returns a discovery diagnostic when a connection slot name violates
- * {@link CONNECTION_SLUG_PATTERN}, or `null` when it satisfies the rule.
- */
-export function createConnectionNameDiagnostic(slotName, sourcePath) {
-    if (CONNECTION_SLUG_PATTERN.test(slotName)) {
-        return null;
-    }
-    return createDiscoverErrorDiagnostic({
-        code: DISCOVER_CONNECTION_NAME_INVALID,
-        message: `Connection filename "${slotName}" is not a legal connection name. ` +
-            `Expected lowercase ASCII letters, digits, and dashes only, starting with a letter, up to 64 characters.`,
-        sourcePath,
-    });
-}
-/**
- * Returns a discovery diagnostic when a channel filesystem segment violates
- * {@link CHANNEL_SLUG_PATTERN}, or `null` when it satisfies the rule.
- *
- * Each path segment under `agent/channels/` is validated independently —
- * file leaves and directory ancestors both go through this check so the
- * runtime never sees a malformed URL segment.
- */
-export function createChannelNameDiagnostic(segment, sourcePath) {
-    if (CHANNEL_SLUG_PATTERN.test(segment)) {
-        return null;
-    }
-    return createDiscoverErrorDiagnostic({
-        code: DISCOVER_CHANNEL_NAME_INVALID,
-        message: `Channel path segment "${segment}" is not a legal channel name. ` +
-            `Expected lowercase kebab-case (\`my-channel\`), optionally with a leading dot (\`.well-known\`), or a path parameter form (\`[sessionId]\`).`,
-        sourcePath,
-    });
-}
-/**
- * Returns a discovery diagnostic when a hook filesystem segment violates
- * {@link HOOK_SLUG_PATTERN}, or `null` when it satisfies the rule.
- *
- * Each path segment under `agent/hooks/` is validated independently so
- * the runtime never sees a malformed slug.
- */
-export function createHookNameDiagnostic(segment, sourcePath) {
-    if (HOOK_SLUG_PATTERN.test(segment)) {
-        return null;
-    }
-    return createDiscoverErrorDiagnostic({
-        code: DISCOVER_HOOK_NAME_INVALID,
-        message: `Hook path segment "${segment}" is not a legal hook name. ` +
-            `Expected ASCII letters, digits, underscores, and dashes only, starting with a letter, up to 64 characters.`,
-        sourcePath,
-    });
-}
-export { discoverNamedSourceDirectory, } from "#discover/named-source-directory.js";
-/**
- * Emits shared diagnostics for unsupported root-level directories.
- */
-export function createUnsupportedRootDirectoryDiagnostics(input) {
-    return input.rootEntries.flatMap((entry) => {
-        if (!entry.isDirectory()) {
-            return [];
-        }
-        if (input.classifyEntry(entry.name, getDirectoryEntryType(entry)) !== "unknown") {
-            return [];
-        }
-        return [
-            createDiscoverWarningDiagnostic({
-                code: DISCOVER_UNSUPPORTED_DIRECTORY,
-                message: input.createUnsupportedDirectoryMessage(entry.name),
-                sourcePath: join(input.rootPath, entry.name),
-            }),
-        ];
-    });
-}
-/**
- * Creates one slot-collision diagnostic with shared wording.
- */
-export function createSlotCollisionDiagnostic(directoryPath, slotLogicalPath, fileNames) {
-    return createDiscoverErrorDiagnostic({
-        code: DISCOVER_SLOT_COLLISION,
-        message: `Found conflicting authored sources for "${slotLogicalPath}": ${formatQuotedFileList(fileNames)}.`,
-        sourcePath: directoryPath,
-    });
-}
-/**
- * Creates one module-slot collision diagnostic with shared wording.
- */
-export function createModuleSlotCollisionDiagnostic(directoryPath, slotLogicalPath, fileNames) {
-    return createDiscoverErrorDiagnostic({
-        code: DISCOVER_MODULE_SLOT_COLLISION,
-        message: `Found multiple authored module sources for "${slotLogicalPath}": ${formatQuotedFileList(fileNames)}.`,
-        sourcePath: directoryPath,
-    });
-}
-function formatQuotedFileList(fileNames) {
-    return fileNames.map((fileName) => `"${fileName}"`).join(", ");
-}
+import{join}from"node:path";import{createDiscoverErrorDiagnostic,createDiscoverWarningDiagnostic}from"#discover/diagnostics.js";import{getDirectoryEntryType}from"#discover/filesystem.js";import{createModuleSourceRef}from"#discover/manifest.js";import{collectFlatSlotCandidates}from"#discover/slots.js";import{lowerInstructionsMarkdown}from"#internal/helpers/markdown.js";import{discoverMarkdownSource}from"#discover/markdown.js";import{discoverNamedSourceDirectory}from"#discover/named-source-directory.js";var DISCOVER_MODULE_SLOT_COLLISION=`discover/module-slot-collision`,DISCOVER_REQUIRED_INSTRUCTIONS_MISSING=`discover/required-instructions-missing`,DISCOVER_DEPRECATED_SYSTEM_SLOT=`discover/deprecated-system-slot`,DISCOVER_SLOT_COLLISION=`discover/slot-collision`,DISCOVER_TOOLS_DIRECTORY_INVALID=`discover/tools-directory-invalid`,DISCOVER_HOOKS_DIRECTORY_INVALID=`discover/hooks-directory-invalid`,DISCOVER_CHANNELS_DIRECTORY_INVALID=`discover/channels-directory-invalid`,DISCOVER_TOOL_NAME_INVALID=`discover/tool-name-invalid`,DISCOVER_CONNECTION_NAME_INVALID=`discover/connection-name-invalid`,DISCOVER_SANDBOX_DIRECTORY_INVALID=`discover/sandbox-directory-invalid`,DISCOVER_CHANNEL_NAME_INVALID=`discover/channel-name-invalid`,DISCOVER_HOOK_NAME_INVALID=`discover/hook-name-invalid`,TOOL_SLUG_PATTERN=/^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/,CONNECTION_SLUG_PATTERN=/^[a-z][a-z0-9-]{0,63}$/,CHANNEL_SLUG_PATTERN=/^(\.?[a-z][a-z0-9-]{0,63}|\[[a-zA-Z][a-zA-Z0-9_]{0,63}\])$/,HOOK_SLUG_PATTERN=/^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/,DISCOVER_UNSUPPORTED_DIRECTORY=`discover/unsupported-directory`;async function readSortedDirectoryEntries(e,t){let n=[...await e.readDirectory(t)];return n.sort((e,t)=>e.name.localeCompare(t.name)),n}async function discoverInstructionsSource(r){let i=await discoverSlotSource({markdownFileName:`instructions.md`,moduleBaseName:`instructions`,rootEntries:r.rootEntries,rootPath:r.rootPath,slotLabel:`instructions`,source:r.source});if(i.diagnostics.length>0||i.source!==void 0)return{diagnostics:i.diagnostics,instructions:i.source};let a=await discoverSlotSource({markdownFileName:`system.md`,moduleBaseName:`system`,rootEntries:r.rootEntries,rootPath:r.rootPath,slotLabel:`system`,source:r.source});if(a.source!==void 0){let t=a.source.sourceKind===`markdown`?`system.md`:a.source.logicalPath;return{diagnostics:[createDiscoverWarningDiagnostic({code:DISCOVER_DEPRECATED_SYSTEM_SLOT,message:`The "${t}" slot is deprecated. Rename it to "${t.replace(/^system/,`instructions`)}" — the runtime still loads the legacy slot for now, but support will be removed in a future release.`,sourcePath:join(r.rootPath,t)}),...a.diagnostics],instructions:a.source}}return a.diagnostics.length>0?{diagnostics:a.diagnostics}:r.required===!1?{diagnostics:[]}:{diagnostics:[createDiscoverErrorDiagnostic({code:DISCOVER_REQUIRED_INSTRUCTIONS_MISSING,message:`Expected one authored instructions prompt source at "instructions.md", "instructions.ts", "instructions.cts", "instructions.mts", "instructions.js", "instructions.cjs", or "instructions.mjs".`,sourcePath:r.rootPath})]}}async function discoverSlotSource(t){let n=collectFlatSlotCandidates(t.rootEntries,{markdownFileName:t.markdownFileName,moduleBaseName:t.moduleBaseName});if(n.markdownFileName!==void 0&&n.moduleFileNames.length>0)return{diagnostics:[createSlotCollisionDiagnostic(t.rootPath,t.slotLabel,[n.markdownFileName,...n.moduleFileNames])]};if(n.moduleFileNames.length>1)return{diagnostics:[createModuleSlotCollisionDiagnostic(t.rootPath,t.slotLabel,n.moduleFileNames)]};if(n.markdownFileName!==void 0)return{diagnostics:[],source:await discoverMarkdownSource({logicalPath:t.markdownFileName,lower:lowerInstructionsMarkdown,source:t.source,sourcePath:join(t.rootPath,n.markdownFileName)})};let[r]=n.moduleFileNames;return r===void 0?{diagnostics:[]}:{diagnostics:[],source:createModuleSourceRef({logicalPath:r})}}function discoverFlatModuleSource(e){let n=collectFlatSlotCandidates(e.rootEntries,{moduleBaseName:e.slotName});if(n.moduleFileNames.length>1)return{diagnostics:[createModuleSlotCollisionDiagnostic(e.rootPath,e.slotName,n.moduleFileNames)]};let[r]=n.moduleFileNames;return r===void 0?e.missingDiagnostic===void 0?{diagnostics:[]}:{diagnostics:[createDiscoverErrorDiagnostic({code:e.missingDiagnostic.code,message:e.missingDiagnostic.message,sourcePath:e.rootPath})]}:{diagnostics:[],module:createModuleSourceRef({logicalPath:r})}}function createToolNameDiagnostic(e,n){return TOOL_SLUG_PATTERN.test(e)?null:createDiscoverErrorDiagnostic({code:DISCOVER_TOOL_NAME_INVALID,message:`Tool filename "${e}" is not a legal tool name. Expected ASCII letters, digits, underscores, and dashes only, starting with a letter, up to 64 characters.`,sourcePath:n})}function createConnectionNameDiagnostic(e,n){return CONNECTION_SLUG_PATTERN.test(e)?null:createDiscoverErrorDiagnostic({code:DISCOVER_CONNECTION_NAME_INVALID,message:`Connection filename "${e}" is not a legal connection name. Expected lowercase ASCII letters, digits, and dashes only, starting with a letter, up to 64 characters.`,sourcePath:n})}function createChannelNameDiagnostic(e,n){return CHANNEL_SLUG_PATTERN.test(e)?null:createDiscoverErrorDiagnostic({code:DISCOVER_CHANNEL_NAME_INVALID,message:`Channel path segment "${e}" is not a legal channel name. Expected lowercase kebab-case (\`my-channel\`), optionally with a leading dot (\`.well-known\`), or a path parameter form (\`[sessionId]\`).`,sourcePath:n})}function createHookNameDiagnostic(e,n){return HOOK_SLUG_PATTERN.test(e)?null:createDiscoverErrorDiagnostic({code:DISCOVER_HOOK_NAME_INVALID,message:`Hook path segment "${e}" is not a legal hook name. Expected ASCII letters, digits, underscores, and dashes only, starting with a letter, up to 64 characters.`,sourcePath:n})}function createUnsupportedRootDirectoryDiagnostics(t){return t.rootEntries.flatMap(i=>!i.isDirectory()||t.classifyEntry(i.name,getDirectoryEntryType(i))!==`unknown`?[]:[createDiscoverWarningDiagnostic({code:DISCOVER_UNSUPPORTED_DIRECTORY,message:t.createUnsupportedDirectoryMessage(i.name),sourcePath:join(t.rootPath,i.name)})])}function createSlotCollisionDiagnostic(e,n,r){return createDiscoverErrorDiagnostic({code:DISCOVER_SLOT_COLLISION,message:`Found conflicting authored sources for "${n}": ${formatQuotedFileList(r)}.`,sourcePath:e})}function createModuleSlotCollisionDiagnostic(e,n,r){return createDiscoverErrorDiagnostic({code:DISCOVER_MODULE_SLOT_COLLISION,message:`Found multiple authored module sources for "${n}": ${formatQuotedFileList(r)}.`,sourcePath:e})}function formatQuotedFileList(e){return e.map(e=>`"${e}"`).join(`, `)}export{CHANNEL_SLUG_PATTERN,CONNECTION_SLUG_PATTERN,DISCOVER_CHANNELS_DIRECTORY_INVALID,DISCOVER_CHANNEL_NAME_INVALID,DISCOVER_CONNECTION_NAME_INVALID,DISCOVER_DEPRECATED_SYSTEM_SLOT,DISCOVER_HOOKS_DIRECTORY_INVALID,DISCOVER_HOOK_NAME_INVALID,DISCOVER_MODULE_SLOT_COLLISION,DISCOVER_REQUIRED_INSTRUCTIONS_MISSING,DISCOVER_SANDBOX_DIRECTORY_INVALID,DISCOVER_SLOT_COLLISION,DISCOVER_TOOLS_DIRECTORY_INVALID,DISCOVER_TOOL_NAME_INVALID,DISCOVER_UNSUPPORTED_DIRECTORY,HOOK_SLUG_PATTERN,TOOL_SLUG_PATTERN,createChannelNameDiagnostic,createConnectionNameDiagnostic,createHookNameDiagnostic,createModuleSlotCollisionDiagnostic,createSlotCollisionDiagnostic,createToolNameDiagnostic,createUnsupportedRootDirectoryDiagnostics,discoverFlatModuleSource,discoverInstructionsSource,discoverNamedSourceDirectory,readSortedDirectoryEntries};

package/dist/src/discover/lib.js

@@ -1,34 +1 @@
-import { discoverNamedSourceDirectory } from "#discover/grammar.js";
-/**
- * Diagnostic emitted when the authored `lib/` root exists but is not a
- * directory.
- */
-export const DISCOVER_LIB_DIRECTORY_INVALID = "discover/lib-directory-invalid";
-/**
- * Diagnostic emitted when discovery finds an unsupported entry under the
- * authored `lib/` tree.
- */
-export const DISCOVER_LIB_ENTRY_UNSUPPORTED = "discover/lib-entry-unsupported";
-/**
- * Discovers module-only helper sources under `lib/` without executing
- * authored modules.
- */
-export async function discoverLibSources(input) {
-    const result = await discoverNamedSourceDirectory({
-        directoryName: "lib",
-        invalidDirectoryCode: DISCOVER_LIB_DIRECTORY_INVALID,
-        invalidDirectoryMessage: `Expected "${input.agentRoot}/lib" to be a directory of authored helper modules.`,
-        recursive: true,
-        rootEntries: input.rootEntries,
-        rootPath: input.agentRoot,
-        source: input.source,
-        unsupportedEntryCode: DISCOVER_LIB_ENTRY_UNSUPPORTED,
-        unsupportedEntryMessage: (sourcePath) => `Expected "${sourcePath}" to be a supported authored module within "lib/".`,
-        unsupportedFileCode: DISCOVER_LIB_ENTRY_UNSUPPORTED,
-        unsupportedFileMessage: (sourcePath) => `Expected "${sourcePath}" to be a supported authored module within "lib/".`,
-    });
-    return {
-        diagnostics: result.diagnostics,
-        lib: result.sources,
-    };
-}
+import{discoverNamedSourceDirectory}from"#discover/grammar.js";var DISCOVER_LIB_DIRECTORY_INVALID=`discover/lib-directory-invalid`,DISCOVER_LIB_ENTRY_UNSUPPORTED=`discover/lib-entry-unsupported`;async function discoverLibSources(t){let n=await discoverNamedSourceDirectory({directoryName:`lib`,invalidDirectoryCode:DISCOVER_LIB_DIRECTORY_INVALID,invalidDirectoryMessage:`Expected "${t.agentRoot}/lib" to be a directory of authored helper modules.`,recursive:!0,rootEntries:t.rootEntries,rootPath:t.agentRoot,source:t.source,unsupportedEntryCode:DISCOVER_LIB_ENTRY_UNSUPPORTED,unsupportedEntryMessage:e=>`Expected "${e}" to be a supported authored module within "lib/".`,unsupportedFileCode:DISCOVER_LIB_ENTRY_UNSUPPORTED,unsupportedFileMessage:e=>`Expected "${e}" to be a supported authored module within "lib/".`});return{diagnostics:n.diagnostics,lib:n.sources}}export{DISCOVER_LIB_DIRECTORY_INVALID,DISCOVER_LIB_ENTRY_UNSUPPORTED,discoverLibSources};