experimental-ash 0.1.0-alpha.1

package/dist/src/discover/filesystem.d.ts

@@ -0,0 +1,108 @@
+import type { Dirent } from "node:fs";
+/**
+ * Supported authored JavaScript and TypeScript module file extensions.
+ */
+export declare const SUPPORTED_AUTHORED_MODULE_FILE_EXTENSIONS: readonly [".ts", ".js", ".mjs"];
+/**
+ * Files that mark a surrounding directory as an application root when paired
+ * with a top-level `agent/` directory.
+ */
+export declare const PROJECT_MARKER_FILE_NAMES: readonly ["package.json", "vercel.json"];
+/**
+ * Supported root-level files inside an agent package.
+ */
+export declare const AGENT_ROOT_FILE_NAMES: readonly ["agent.ts", "agent.js", "agent.mjs", "system.md", "system.ts", "system.js", "system.mjs"];
+/**
+ * Supported root-level directories inside an agent package.
+ */
+export declare const AGENT_ROOT_DIRECTORY_NAMES: readonly ["context", "lib", "sandboxes", "skills", "tools", "schedules", "workspace", "subagents"];
+/**
+ * Supported local-subagent entry file names.
+ */
+export declare const LOCAL_SUBAGENT_FILE_NAMES: readonly ["subagent.ts", "subagent.js", "subagent.mjs", "system.md", "system.ts", "system.js", "system.mjs"];
+/**
+ * Supported local-subagent subdirectories.
+ */
+export declare const LOCAL_SUBAGENT_DIRECTORY_NAMES: readonly ["lib", "sandboxes", "skills", "tools", "subagents"];
+/**
+ * Supported Agent Skills package entries.
+ */
+export declare const SKILL_PACKAGE_FILE_NAMES: readonly ["SKILL.md"];
+/**
+ * Optional Agent Skills package subdirectories.
+ */
+export declare const SKILL_PACKAGE_DIRECTORY_NAMES: readonly ["scripts", "references", "assets"];
+/**
+ * Filesystem entry type used by discovery classifiers.
+ */
+export type DirectoryEntryType = "directory" | "file" | "other";
+/**
+ * Classified root-level agent entry.
+ */
+export type AgentRootEntryKind = "agent-config-module" | "context-directory" | "lib-directory" | "sandboxes-directory" | "schedules-directory" | "skills-directory" | "system-markdown" | "system-module" | "tools-directory" | "unknown" | "workspace-directory" | "subagents-directory";
+/**
+ * Classified local-subagent root entry.
+ */
+export type LocalSubagentEntryKind = "invalid-schedules-directory" | "lib-directory" | "sandboxes-directory" | "skills-directory" | "system-markdown" | "system-module" | "tools-directory" | "unknown" | "subagent-module" | "subagents-directory";
+/**
+ * Classified Agent Skills package entry.
+ */
+export type SkillPackageEntryKind = "skill-assets-directory" | "skill-markdown" | "skill-references-directory" | "skill-resource" | "skill-scripts-directory";
+/**
+ * Classified top-level entry inside `skills/`.
+ */
+export type SkillsDirectoryEntryKind = "flat-skill-markdown" | "flat-skill-module" | "skill-package-directory" | "unknown";
+/**
+ * Returns the normalized entry type for a Node filesystem dirent.
+ */
+export declare function getDirectoryEntryType(entry: Pick<Dirent, "isDirectory" | "isFile">): DirectoryEntryType;
+/**
+ * Returns whether an entry marks a directory as an app root for nested agents.
+ */
+export declare function isProjectMarkerEntry(name: string, entryType: DirectoryEntryType): boolean;
+/**
+ * Classifies a top-level agent-root entry according to the spec-legal grammar.
+ */
+export declare function classifyAgentRootEntry(name: string, entryType: DirectoryEntryType): AgentRootEntryKind;
+/**
+ * Classifies a local-subagent package root entry according to the spec-legal grammar.
+ */
+export declare function classifyLocalSubagentEntry(name: string, entryType: DirectoryEntryType): LocalSubagentEntryKind;
+/**
+ * Classifies a file or directory inside an Agent Skills package.
+ */
+export declare function classifySkillPackageEntry(name: string, entryType: DirectoryEntryType): SkillPackageEntryKind;
+/**
+ * Classifies one top-level entry inside the authored `skills/` directory.
+ */
+export declare function classifySkillsDirectoryEntry(name: string, entryType: DirectoryEntryType): SkillsDirectoryEntryKind;
+/**
+ * Returns whether a directory entry is a supported root-level agent entry.
+ */
+export declare function isAgentRootEntry(name: string, entryType: DirectoryEntryType): boolean;
+/**
+ * Returns whether a directory entry is a supported local-subagent root entry.
+ */
+export declare function isLocalSubagentEntry(name: string, entryType: DirectoryEntryType): boolean;
+/**
+ * Returns whether a directory entry is a recognized Agent Skills package entry.
+ */
+export declare function isSkillPackageEntry(name: string, entryType: DirectoryEntryType): boolean;
+/**
+ * Normalizes an agent-root-relative logical path to forward slashes.
+ */
+export declare function normalizeLogicalPath(input: string): string;
+/**
+ * Returns the authored module basename when the file uses a supported module
+ * extension.
+ */
+export declare function getSupportedModuleBaseName(name: string): string | null;
+/**
+ * Returns whether the file name matches one supported authored module basename.
+ */
+export declare function matchesSupportedModuleBaseName(name: string, baseName: string): boolean;
+/**
+ * Removes a final file extension from a logical path when present.
+ */
+export declare function stripLogicalPathExtension(input: string): string;
+//# sourceMappingURL=filesystem.d.ts.map

package/dist/src/discover/filesystem.d.ts.map

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

package/dist/src/discover/filesystem.js

@@ -0,0 +1,270 @@
+import { sep } from "node:path";
+/**
+ * Supported authored JavaScript and TypeScript module file extensions.
+ */
+export const SUPPORTED_AUTHORED_MODULE_FILE_EXTENSIONS = [".ts", ".js", ".mjs"];
+/**
+ * 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"];
+/**
+ * Supported root-level files inside an agent package.
+ */
+export const AGENT_ROOT_FILE_NAMES = [
+    "agent.ts",
+    "agent.js",
+    "agent.mjs",
+    "system.md",
+    "system.ts",
+    "system.js",
+    "system.mjs",
+];
+/**
+ * Supported root-level directories inside an agent package.
+ */
+export const AGENT_ROOT_DIRECTORY_NAMES = [
+    "context",
+    "lib",
+    "sandboxes",
+    "skills",
+    "tools",
+    "schedules",
+    "workspace",
+    "subagents",
+];
+/**
+ * Supported local-subagent entry file names.
+ */
+export const LOCAL_SUBAGENT_FILE_NAMES = [
+    "subagent.ts",
+    "subagent.js",
+    "subagent.mjs",
+    "system.md",
+    "system.ts",
+    "system.js",
+    "system.mjs",
+];
+/**
+ * Supported local-subagent subdirectories.
+ */
+export const LOCAL_SUBAGENT_DIRECTORY_NAMES = [
+    "lib",
+    "sandboxes",
+    "skills",
+    "tools",
+    "subagents",
+];
+/**
+ * Supported Agent Skills package entries.
+ */
+export const SKILL_PACKAGE_FILE_NAMES = ["SKILL.md"];
+/**
+ * Optional Agent Skills package subdirectories.
+ */
+export const SKILL_PACKAGE_DIRECTORY_NAMES = ["scripts", "references", "assets"];
+const PROJECT_MARKER_FILE_NAME_SET = new Set(PROJECT_MARKER_FILE_NAMES);
+const AGENT_ROOT_FILE_NAME_SET = new Set(AGENT_ROOT_FILE_NAMES);
+const AGENT_ROOT_DIRECTORY_NAME_SET = new Set(AGENT_ROOT_DIRECTORY_NAMES);
+const LOCAL_SUBAGENT_FILE_NAME_SET = new Set(LOCAL_SUBAGENT_FILE_NAMES);
+const LOCAL_SUBAGENT_DIRECTORY_NAME_SET = new Set(LOCAL_SUBAGENT_DIRECTORY_NAMES);
+const SKILL_PACKAGE_FILE_NAME_SET = new Set(SKILL_PACKAGE_FILE_NAMES);
+const SKILL_PACKAGE_DIRECTORY_NAME_SET = new Set(SKILL_PACKAGE_DIRECTORY_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 === "system.md") {
+            return "system-markdown";
+        }
+        if (matchesSupportedModuleBaseName(name, "system")) {
+            return "system-module";
+        }
+        return "unknown";
+    }
+    if (entryType === "directory") {
+        if (name === "context") {
+            return "context-directory";
+        }
+        if (name === "lib") {
+            return "lib-directory";
+        }
+        if (name === "skills") {
+            return "skills-directory";
+        }
+        if (name === "sandboxes") {
+            return "sandboxes-directory";
+        }
+        if (name === "tools") {
+            return "tools-directory";
+        }
+        if (name === "schedules") {
+            return "schedules-directory";
+        }
+        if (name === "workspace") {
+            return "workspace-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, "subagent")) {
+            return "subagent-module";
+        }
+        if (name === "system.md") {
+            return "system-markdown";
+        }
+        if (matchesSupportedModuleBaseName(name, "system")) {
+            return "system-module";
+        }
+        return "unknown";
+    }
+    if (entryType === "directory") {
+        if (name === "lib") {
+            return "lib-directory";
+        }
+        if (name === "sandboxes") {
+            return "sandboxes-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";
+}
+/**
+ * Returns whether a directory entry is a supported root-level agent entry.
+ */
+export function isAgentRootEntry(name, entryType) {
+    return ((entryType === "file" && AGENT_ROOT_FILE_NAME_SET.has(name)) ||
+        (entryType === "directory" && AGENT_ROOT_DIRECTORY_NAME_SET.has(name)));
+}
+/**
+ * Returns whether a directory entry is a supported local-subagent root entry.
+ */
+export function isLocalSubagentEntry(name, entryType) {
+    return ((entryType === "file" && LOCAL_SUBAGENT_FILE_NAME_SET.has(name)) ||
+        (entryType === "directory" && LOCAL_SUBAGENT_DIRECTORY_NAME_SET.has(name)));
+}
+/**
+ * Returns whether a directory entry is a recognized Agent Skills package entry.
+ */
+export function isSkillPackageEntry(name, entryType) {
+    return ((entryType === "file" && SKILL_PACKAGE_FILE_NAME_SET.has(name)) ||
+        (entryType === "directory" && SKILL_PACKAGE_DIRECTORY_NAME_SET.has(name)));
+}
+/**
+ * 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);
+}
+//# sourceMappingURL=filesystem.js.map

package/dist/src/discover/filesystem.js.map

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

package/dist/src/discover/grammar.d.ts

@@ -0,0 +1,104 @@
+import type { Dirent } from "node:fs";
+import type { MarkdownSourceRef, ModuleSourceRef } from "../internal/source-ref.js";
+import type { SystemDefinition } from "../public/definitions/system.js";
+import { type DiscoverDiagnostic } from "./diagnostics.js";
+import { type DirectoryEntryType } from "./filesystem.js";
+/**
+ * Shared diagnostic emitted when discovery finds a legacy `memories/`
+ * directory.
+ */
+export declare const DISCOVER_LEGACY_MEMORIES_DIRECTORY_UNSUPPORTED = "discover/legacy-memories-directory-unsupported";
+/**
+ * Shared diagnostic emitted when a slot has multiple authored module sources.
+ */
+export declare const DISCOVER_MODULE_SLOT_COLLISION = "discover/module-slot-collision";
+/**
+ * Shared diagnostic emitted when the required system prompt source is missing.
+ */
+export declare const DISCOVER_REQUIRED_SYSTEM_MISSING = "discover/required-system-missing";
+/**
+ * Shared diagnostic emitted when a slot has both markdown and module sources.
+ */
+export declare const DISCOVER_SLOT_COLLISION = "discover/slot-collision";
+/**
+ * Shared diagnostic emitted when the authored `tools/` root is not a
+ * directory.
+ */
+export declare const DISCOVER_TOOLS_DIRECTORY_INVALID = "discover/tools-directory-invalid";
+/**
+ * Shared diagnostic emitted when the authored `sandboxes/` root is not a
+ * directory.
+ */
+export declare const DISCOVER_SANDBOXES_DIRECTORY_INVALID = "discover/sandboxes-directory-invalid";
+/**
+ * Shared diagnostic emitted when discovery ignores one unsupported directory.
+ */
+export declare const DISCOVER_UNSUPPORTED_DIRECTORY = "discover/unsupported-directory";
+export type StringDirent = Dirent<string>;
+type SystemSourceRef = MarkdownSourceRef<SystemDefinition> | ModuleSourceRef;
+/**
+ * Reads one directory and returns its entries sorted by name.
+ */
+export declare function readSortedDirectoryEntries(directoryPath: string): Promise<StringDirent[]>;
+/**
+ * Returns the current filesystem type for one path, including missing paths.
+ */
+export declare function getPathType(targetPath: string): Promise<"directory" | "file" | "missing" | "other">;
+/**
+ * Discovers one required `system.md|ts|js|mjs` source from a root directory.
+ */
+export declare function discoverSystemSource(input: {
+    rootEntries: readonly StringDirent[];
+    rootPath: string;
+}): Promise<{
+    diagnostics: DiscoverDiagnostic[];
+    system?: SystemSourceRef;
+}>;
+/**
+ * Discovers one flat module slot such as `agent.ts` or `subagent.mjs`.
+ */
+export declare function discoverFlatModuleSource(input: {
+    missingDiagnostic?: {
+        code: string;
+        message: string;
+    };
+    rootEntries: readonly StringDirent[];
+    rootPath: string;
+    slotName: string;
+}): {
+    diagnostics: DiscoverDiagnostic[];
+    module?: ModuleSourceRef;
+};
+/**
+ * Discovers one named directory of module-backed sources such as `tools/`.
+ */
+export declare function discoverNamedModuleDirectorySources(input: {
+    directoryName: string;
+    invalidDirectoryCode: string;
+    invalidDirectoryMessage: string;
+    rootEntries: readonly StringDirent[];
+    rootPath: string;
+}): Promise<{
+    diagnostics: DiscoverDiagnostic[];
+    modules: ModuleSourceRef[];
+}>;
+/**
+ * Emits shared diagnostics for legacy `memories/` directories and otherwise
+ * unsupported root-level directories.
+ */
+export declare function createUnsupportedRootDirectoryDiagnostics(input: {
+    classifyEntry: (name: string, entryType: DirectoryEntryType) => string;
+    createUnsupportedDirectoryMessage: (directoryName: string) => string;
+    rootEntries: readonly StringDirent[];
+    rootPath: string;
+}): DiscoverDiagnostic[];
+/**
+ * Creates one slot-collision diagnostic with shared wording.
+ */
+export declare function createSlotCollisionDiagnostic(directoryPath: string, slotLogicalPath: string, fileNames: readonly string[]): DiscoverDiagnostic;
+/**
+ * Creates one module-slot collision diagnostic with shared wording.
+ */
+export declare function createModuleSlotCollisionDiagnostic(directoryPath: string, slotLogicalPath: string, fileNames: readonly string[]): DiscoverDiagnostic;
+export {};
+//# sourceMappingURL=grammar.d.ts.map

package/dist/src/discover/grammar.d.ts.map

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