experimental-ash 0.1.0-alpha.1

package/dist/src/discover/skills.js

@@ -0,0 +1,323 @@
+import { readdir, readFile, stat } from "node:fs/promises";
+import { join, relative, resolve } from "node:path";
+import { lowerFlatSkillMarkdown, lowerSkillMarkdown } from "../public/helpers/markdown.js";
+import { createDiscoverErrorDiagnostic } from "./diagnostics.js";
+import { classifySkillPackageEntry, classifySkillsDirectoryEntry, getDirectoryEntryType, getSupportedModuleBaseName, normalizeLogicalPath, } from "./filesystem.js";
+import { createModuleSourceRef, createPathDerivedSourceId, createSkillPackageSourceRef, } from "./manifest.js";
+/**
+ * Diagnostics emitted by skill discovery.
+ */
+export const DISCOVER_SKILLS_DIRECTORY_INVALID = "discover/skills-directory-invalid";
+export const DISCOVER_SKILL_COLLISION = "discover/skill-collision";
+export const DISCOVER_SKILL_ENTRY_NOT_DIRECTORY = "discover/skill-entry-not-directory";
+export const DISCOVER_SKILL_FRONTMATTER_INVALID = "discover/skill-frontmatter-invalid";
+export const DISCOVER_SKILL_MARKDOWN_MISSING = "discover/skill-markdown-missing";
+export const DISCOVER_SKILL_NAME_MISMATCH = "discover/skill-name-mismatch";
+/**
+ * Discovers authored skills from either flat `skills/<name>.md|ts|js|mjs`
+ * entries or Agent Skills packages rooted at `skills/<name>/SKILL.md`.
+ */
+export async function discoverSkills(input) {
+    const agentRoot = resolve(input.agentRoot);
+    const skillsDirectoryPath = resolve(input.skillsDirectoryPath ?? join(agentRoot, "skills"));
+    const skillsLogicalPath = normalizeLogicalPath(input.skillsLogicalPath ?? relative(agentRoot, skillsDirectoryPath));
+    const skillsDirectoryType = await getPathType(skillsDirectoryPath);
+    if (skillsDirectoryType === "missing") {
+        return {
+            diagnostics: [],
+            skills: [],
+        };
+    }
+    if (skillsDirectoryType !== "directory") {
+        return {
+            diagnostics: [
+                createDiscoverErrorDiagnostic({
+                    code: DISCOVER_SKILLS_DIRECTORY_INVALID,
+                    message: `Expected "${skillsDirectoryPath}" to be a directory of authored skills.`,
+                    sourcePath: skillsDirectoryPath,
+                }),
+            ],
+            skills: [],
+        };
+    }
+    const diagnostics = [];
+    const collidedSkillIds = new Set();
+    const skillsById = new Map();
+    const entries = await readdir(skillsDirectoryPath, {
+        withFileTypes: true,
+    });
+    for (const entry of [...entries].sort((left, right) => left.name.localeCompare(right.name))) {
+        const discoveredSkill = await discoverOneSkill({
+            entryName: entry.name,
+            entryType: getDirectoryEntryType(entry),
+            skillsDirectoryPath,
+            skillsLogicalPath,
+        });
+        diagnostics.push(...discoveredSkill.diagnostics);
+        if (discoveredSkill.skill === null || discoveredSkill.skillId === null) {
+            continue;
+        }
+        if (collidedSkillIds.has(discoveredSkill.skillId)) {
+            continue;
+        }
+        const existingSkill = skillsById.get(discoveredSkill.skillId);
+        if (existingSkill !== undefined) {
+            diagnostics.push(createDiscoverErrorDiagnostic({
+                code: DISCOVER_SKILL_COLLISION,
+                message: `Found conflicting authored skill sources for "${discoveredSkill.skillId}": "${existingSkill.logicalPath}" and "${discoveredSkill.logicalPath}".`,
+                sourcePath: join(skillsDirectoryPath, discoveredSkill.skillId),
+            }));
+            collidedSkillIds.add(discoveredSkill.skillId);
+            skillsById.delete(discoveredSkill.skillId);
+            continue;
+        }
+        skillsById.set(discoveredSkill.skillId, {
+            logicalPath: discoveredSkill.logicalPath,
+            skill: discoveredSkill.skill,
+        });
+    }
+    return {
+        diagnostics,
+        skills: [...skillsById.values()].map((entry) => entry.skill),
+    };
+}
+async function discoverOneSkill(input) {
+    const entryPath = join(input.skillsDirectoryPath, input.entryName);
+    switch (classifySkillsDirectoryEntry(input.entryName, input.entryType)) {
+        case "skill-package-directory":
+            return discoverPackagedSkill({
+                logicalSkillsPath: input.skillsLogicalPath,
+                skillId: input.entryName,
+                skillRootPath: entryPath,
+            });
+        case "flat-skill-markdown":
+            return discoverFlatMarkdownSkill({
+                logicalSkillsPath: input.skillsLogicalPath,
+                skillFileName: input.entryName,
+                skillFilePath: entryPath,
+            });
+        case "flat-skill-module":
+            return discoverFlatModuleSkill({
+                logicalSkillsPath: input.skillsLogicalPath,
+                skillFileName: input.entryName,
+            });
+        default:
+            return {
+                diagnostics: [
+                    createDiscoverErrorDiagnostic({
+                        code: DISCOVER_SKILL_ENTRY_NOT_DIRECTORY,
+                        message: `Expected "${entryPath}" to be a skill directory containing SKILL.md or a flat ".md", ".ts", ".js", or ".mjs" skill file.`,
+                        sourcePath: entryPath,
+                    }),
+                ],
+                logicalPath: normalizeLogicalPath(join(input.skillsLogicalPath, input.entryName)),
+                skill: null,
+                skillId: null,
+            };
+    }
+}
+async function discoverPackagedSkill(input) {
+    const skillFilePath = join(input.skillRootPath, "SKILL.md");
+    const logicalPath = normalizeLogicalPath(join(input.logicalSkillsPath, input.skillId, "SKILL.md"));
+    if ((await getPathType(skillFilePath)) !== "file") {
+        return {
+            diagnostics: [
+                createDiscoverErrorDiagnostic({
+                    code: DISCOVER_SKILL_MARKDOWN_MISSING,
+                    message: `Expected "${skillFilePath}" to exist for the "${input.skillId}" skill.`,
+                    sourcePath: input.skillRootPath,
+                }),
+            ],
+            logicalPath,
+            skill: null,
+            skillId: null,
+        };
+    }
+    let definition;
+    try {
+        definition = lowerSkillMarkdown(await readFile(skillFilePath, "utf8"), {
+            id: input.skillId,
+        });
+    }
+    catch (error) {
+        return {
+            diagnostics: [
+                createDiscoverErrorDiagnostic({
+                    code: DISCOVER_SKILL_FRONTMATTER_INVALID,
+                    message: formatSkillDiscoveryError(skillFilePath, error),
+                    sourcePath: skillFilePath,
+                }),
+            ],
+            logicalPath,
+            skill: null,
+            skillId: null,
+        };
+    }
+    if (definition.name !== input.skillId) {
+        return {
+            diagnostics: [
+                createDiscoverErrorDiagnostic({
+                    code: DISCOVER_SKILL_NAME_MISMATCH,
+                    message: `Expected skill frontmatter name "${definition.name}" to match directory "${input.skillId}".`,
+                    sourcePath: skillFilePath,
+                }),
+            ],
+            logicalPath,
+            skill: null,
+            skillId: null,
+        };
+    }
+    const packagePaths = await discoverSkillPackagePaths(input.skillRootPath);
+    const skillSourceRefInput = {
+        description: definition.description,
+        logicalPath,
+        markdown: definition.markdown,
+        name: definition.name,
+        rootPath: input.skillRootPath,
+        skillFilePath,
+        skillId: input.skillId,
+        sourceId: createPathDerivedSourceId(logicalPath),
+    };
+    if (packagePaths.assetsPath !== undefined) {
+        skillSourceRefInput.assetsPath = packagePaths.assetsPath;
+    }
+    if (definition.compatibility !== undefined) {
+        skillSourceRefInput.compatibility = definition.compatibility;
+    }
+    if (definition.license !== undefined) {
+        skillSourceRefInput.license = definition.license;
+    }
+    if (definition.metadata !== undefined) {
+        skillSourceRefInput.metadata = definition.metadata;
+    }
+    if (packagePaths.referencesPath !== undefined) {
+        skillSourceRefInput.referencesPath = packagePaths.referencesPath;
+    }
+    if (packagePaths.scriptsPath !== undefined) {
+        skillSourceRefInput.scriptsPath = packagePaths.scriptsPath;
+    }
+    return {
+        diagnostics: [],
+        logicalPath,
+        skill: createSkillPackageSourceRef(skillSourceRefInput),
+        skillId: input.skillId,
+    };
+}
+async function discoverFlatMarkdownSkill(input) {
+    const skillId = stripMarkdownExtension(input.skillFileName);
+    const logicalPath = normalizeLogicalPath(join(input.logicalSkillsPath, input.skillFileName));
+    let definition;
+    try {
+        definition = lowerFlatSkillMarkdown(await readFile(input.skillFilePath, "utf8"), {
+            id: skillId,
+            name: skillId,
+        });
+    }
+    catch (error) {
+        return {
+            diagnostics: [
+                createDiscoverErrorDiagnostic({
+                    code: DISCOVER_SKILL_FRONTMATTER_INVALID,
+                    message: formatSkillDiscoveryError(input.skillFilePath, error),
+                    sourcePath: input.skillFilePath,
+                }),
+            ],
+            logicalPath,
+            skill: null,
+            skillId: null,
+        };
+    }
+    if (definition.name !== skillId) {
+        return {
+            diagnostics: [
+                createDiscoverErrorDiagnostic({
+                    code: DISCOVER_SKILL_NAME_MISMATCH,
+                    message: `Expected skill frontmatter name "${definition.name}" to match file "${input.skillFileName}".`,
+                    sourcePath: input.skillFilePath,
+                }),
+            ],
+            logicalPath,
+            skill: null,
+            skillId: null,
+        };
+    }
+    return {
+        diagnostics: [],
+        logicalPath,
+        skill: {
+            definition,
+            kind: "markdown",
+            logicalPath,
+            sourceId: createPathDerivedSourceId(logicalPath),
+        },
+        skillId,
+    };
+}
+async function discoverFlatModuleSkill(input) {
+    const skillId = getSupportedModuleBaseName(input.skillFileName);
+    const logicalPath = normalizeLogicalPath(join(input.logicalSkillsPath, input.skillFileName));
+    if (skillId === null) {
+        return {
+            diagnostics: [],
+            logicalPath,
+            skill: null,
+            skillId: null,
+        };
+    }
+    return {
+        diagnostics: [],
+        logicalPath,
+        skill: createModuleSourceRef({
+            logicalPath,
+        }),
+        skillId,
+    };
+}
+async function discoverSkillPackagePaths(skillRootPath) {
+    const entries = await readdir(skillRootPath, {
+        withFileTypes: true,
+    });
+    const packagePaths = {};
+    for (const entry of entries) {
+        if (!entry.isDirectory()) {
+            continue;
+        }
+        switch (classifySkillPackageEntry(entry.name, getDirectoryEntryType(entry))) {
+            case "skill-assets-directory":
+                packagePaths.assetsPath = join(skillRootPath, entry.name);
+                break;
+            case "skill-references-directory":
+                packagePaths.referencesPath = join(skillRootPath, entry.name);
+                break;
+            case "skill-scripts-directory":
+                packagePaths.scriptsPath = join(skillRootPath, entry.name);
+                break;
+            default:
+                break;
+        }
+    }
+    return packagePaths;
+}
+async function getPathType(path) {
+    try {
+        const stats = await stat(path);
+        if (stats.isDirectory()) {
+            return "directory";
+        }
+        if (stats.isFile()) {
+            return "file";
+        }
+        return "other";
+    }
+    catch {
+        return "missing";
+    }
+}
+function formatSkillDiscoveryError(skillFilePath, error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    return `Invalid authored skill frontmatter in "${skillFilePath}": ${detail}`;
+}
+function stripMarkdownExtension(input) {
+    return input.endsWith(".md") ? input.slice(0, -".md".length) : input;
+}
+//# sourceMappingURL=skills.js.map

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

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

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

@@ -0,0 +1,30 @@
+import type { Dirent } from "node:fs";
+/**
+ * Candidate authored sources for one flat slot such as `system` or `agent`.
+ */
+export interface FlatSlotCandidates {
+    markdownFileName?: string;
+    moduleFileNames: string[];
+}
+/**
+ * Candidate authored sources for one named directory slot such as
+ * `tools/<name>`.
+ */
+export interface NamedSlotCandidates extends FlatSlotCandidates {
+    slotName: string;
+}
+/**
+ * Collects markdown and module candidates for one flat slot in one directory.
+ */
+export declare function collectFlatSlotCandidates(entries: readonly Pick<Dirent<string>, "isFile" | "name">[], input: {
+    markdownFileName?: string;
+    moduleBaseName?: string;
+}): FlatSlotCandidates;
+/**
+ * Groups markdown and module candidates for directory-backed named slots.
+ */
+export declare function collectNamedSlotCandidates(entries: readonly Pick<Dirent<string>, "isFile" | "name">[], input: {
+    allowMarkdown: boolean;
+    allowModules: boolean;
+}): NamedSlotCandidates[];
+//# sourceMappingURL=slots.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../../../src/discover/slots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAItC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,SAAS,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC,EAAE,EAC3D,KAAK,EAAE;IACL,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACA,kBAAkB,CA0BpB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,SAAS,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC,EAAE,EAC3D,KAAK,EAAE;IACL,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;CACvB,GACA,mBAAmB,EAAE,CA0CvB"}

package/dist/src/discover/slots.js

@@ -0,0 +1,69 @@
+import { getSupportedModuleBaseName } from "./filesystem.js";
+/**
+ * Collects markdown and module candidates for one flat slot in one directory.
+ */
+export function collectFlatSlotCandidates(entries, input) {
+    const candidates = {
+        moduleFileNames: [],
+    };
+    for (const entry of entries) {
+        if (!entry.isFile()) {
+            continue;
+        }
+        if (input.markdownFileName !== undefined && entry.name === input.markdownFileName) {
+            candidates.markdownFileName = entry.name;
+            continue;
+        }
+        if (input.moduleBaseName !== undefined &&
+            getSupportedModuleBaseName(entry.name) === input.moduleBaseName) {
+            candidates.moduleFileNames.push(entry.name);
+        }
+    }
+    candidates.moduleFileNames.sort((left, right) => left.localeCompare(right));
+    return candidates;
+}
+/**
+ * Groups markdown and module candidates for directory-backed named slots.
+ */
+export function collectNamedSlotCandidates(entries, input) {
+    const candidatesBySlotName = new Map();
+    for (const entry of entries) {
+        if (!entry.isFile()) {
+            continue;
+        }
+        const markdownSlotName = input.allowMarkdown ? getMarkdownSlotName(entry.name) : null;
+        const moduleSlotName = input.allowModules ? getSupportedModuleBaseName(entry.name) : null;
+        const slotName = markdownSlotName ?? moduleSlotName;
+        if (slotName === null) {
+            continue;
+        }
+        let slotCandidates = candidatesBySlotName.get(slotName);
+        if (slotCandidates === undefined) {
+            slotCandidates = {
+                moduleFileNames: [],
+                slotName,
+            };
+            candidatesBySlotName.set(slotName, slotCandidates);
+        }
+        if (markdownSlotName !== null) {
+            slotCandidates.markdownFileName = entry.name;
+            continue;
+        }
+        if (moduleSlotName !== null) {
+            slotCandidates.moduleFileNames.push(entry.name);
+        }
+    }
+    return [...candidatesBySlotName.values()]
+        .map((slotCandidates) => {
+        slotCandidates.moduleFileNames.sort((left, right) => left.localeCompare(right));
+        return slotCandidates;
+    })
+        .sort((left, right) => left.slotName.localeCompare(right.slotName));
+}
+function getMarkdownSlotName(name) {
+    if (!name.endsWith(".md") || name.length <= ".md".length) {
+        return null;
+    }
+    return name.slice(0, -".md".length);
+}
+//# sourceMappingURL=slots.js.map

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

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

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

@@ -0,0 +1,35 @@
+import type { Dirent } from "node:fs";
+import { type DiscoverDiagnostic } from "./diagnostics.js";
+import { type WorkspaceFileSourceRef } from "./manifest.js";
+/**
+ * Diagnostic emitted when the authored `workspace/` root exists but is not a
+ * directory.
+ */
+export declare const DISCOVER_WORKSPACE_DIRECTORY_INVALID = "discover/workspace-directory-invalid";
+/**
+ * Diagnostic emitted when discovery finds an unsupported non-file entry under
+ * the authored `workspace/` tree.
+ */
+export declare const DISCOVER_WORKSPACE_ENTRY_UNSUPPORTED = "discover/workspace-entry-unsupported";
+type StringDirent = Dirent<string>;
+/**
+ * Input for discovering authored `workspace/` seed files.
+ */
+export interface DiscoverWorkspaceSourcesInput {
+    agentRoot: string;
+    rootEntries: readonly StringDirent[];
+}
+/**
+ * Result of recursively discovering authored `workspace/` seed files.
+ */
+export interface DiscoverWorkspaceSourcesResult {
+    diagnostics: DiscoverDiagnostic[];
+    workspace: WorkspaceFileSourceRef[];
+}
+/**
+ * Discovers opaque authored files under `workspace/` without assigning any
+ * module semantics to file extensions.
+ */
+export declare function discoverWorkspaceSources(input: DiscoverWorkspaceSourcesInput): Promise<DiscoverWorkspaceSourcesResult>;
+export {};
+//# sourceMappingURL=workspace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../src/discover/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAItC,OAAO,EAAiC,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EAAgC,KAAK,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAG1F;;;GAGG;AACH,eAAO,MAAM,oCAAoC,yCAAyC,CAAC;AAE3F;;;GAGG;AACH,eAAO,MAAM,oCAAoC,yCAAyC,CAAC;AAE3F,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;AAEnC;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,SAAS,YAAY,EAAE,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,SAAS,EAAE,sBAAsB,EAAE,CAAC;CACrC;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,8BAA8B,CAAC,CA6CzC"}

package/dist/src/discover/workspace.js

@@ -0,0 +1,61 @@
+import { stat } from "node:fs/promises";
+import { join } from "node:path";
+import { createDiscoverErrorDiagnostic } from "./diagnostics.js";
+import { createWorkspaceFileSourceRef } from "./manifest.js";
+import { discoverResourceTree } from "./resource-tree.js";
+/**
+ * Diagnostic emitted when the authored `workspace/` root exists but is not a
+ * directory.
+ */
+export const DISCOVER_WORKSPACE_DIRECTORY_INVALID = "discover/workspace-directory-invalid";
+/**
+ * Diagnostic emitted when discovery finds an unsupported non-file entry under
+ * the authored `workspace/` tree.
+ */
+export const DISCOVER_WORKSPACE_ENTRY_UNSUPPORTED = "discover/workspace-entry-unsupported";
+/**
+ * Discovers opaque authored files under `workspace/` without assigning any
+ * module semantics to file extensions.
+ */
+export async function discoverWorkspaceSources(input) {
+    const workspaceRoot = join(input.agentRoot, "workspace");
+    const workspaceDirectoryEntry = input.rootEntries.find((entry) => entry.name === "workspace");
+    if (workspaceDirectoryEntry === undefined) {
+        return {
+            diagnostics: [],
+            workspace: [],
+        };
+    }
+    if (!workspaceDirectoryEntry.isDirectory()) {
+        return {
+            diagnostics: [
+                createDiscoverErrorDiagnostic({
+                    code: DISCOVER_WORKSPACE_DIRECTORY_INVALID,
+                    message: `Expected "${workspaceRoot}" to be a directory of authored workspace seed files.`,
+                    sourcePath: workspaceRoot,
+                }),
+            ],
+            workspace: [],
+        };
+    }
+    const diagnostics = [];
+    const workspace = await discoverResourceTree({
+        async createFileEntry({ logicalPath, sourcePath }) {
+            const entryStat = await stat(sourcePath);
+            return createWorkspaceFileSourceRef({
+                byteSize: entryStat.size,
+                logicalPath,
+            });
+        },
+        diagnostics,
+        directoryPath: workspaceRoot,
+        logicalDirectoryPath: "workspace",
+        unsupportedEntryCode: DISCOVER_WORKSPACE_ENTRY_UNSUPPORTED,
+        unsupportedEntryDescription: "workspace",
+    });
+    return {
+        diagnostics,
+        workspace,
+    };
+}
+//# sourceMappingURL=workspace.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../../src/discover/workspace.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,6BAA6B,EAA2B,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EAAE,4BAA4B,EAA+B,MAAM,eAAe,CAAC;AAC1F,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;;GAGG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,sCAAsC,CAAC;AAE3F;;;GAGG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,sCAAsC,CAAC;AAoB3F;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,KAAoC;IAEpC,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACzD,MAAM,uBAAuB,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;IAE9F,IAAI,uBAAuB,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO;YACL,WAAW,EAAE,EAAE;YACf,SAAS,EAAE,EAAE;SACd,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,uBAAuB,CAAC,WAAW,EAAE,EAAE,CAAC;QAC3C,OAAO;YACL,WAAW,EAAE;gBACX,6BAA6B,CAAC;oBAC5B,IAAI,EAAE,oCAAoC;oBAC1C,OAAO,EAAE,aAAa,aAAa,uDAAuD;oBAC1F,UAAU,EAAE,aAAa;iBAC1B,CAAC;aACH;YACD,SAAS,EAAE,EAAE;SACd,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAyB,EAAE,CAAC;IAC7C,MAAM,SAAS,GAAG,MAAM,oBAAoB,CAAC;QAC3C,KAAK,CAAC,eAAe,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE;YAC/C,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC;YAEzC,OAAO,4BAA4B,CAAC;gBAClC,QAAQ,EAAE,SAAS,CAAC,IAAI;gBACxB,WAAW;aACZ,CAAC,CAAC;QACL,CAAC;QACD,WAAW;QACX,aAAa,EAAE,aAAa;QAC5B,oBAAoB,EAAE,WAAW;QACjC,oBAAoB,EAAE,oCAAoC;QAC1D,2BAA2B,EAAE,WAAW;KACzC,CAAC,CAAC;IAEH,OAAO;QACL,WAAW;QACX,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./public/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,2 @@
+export * from "./public/index.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/src/internal/application/compiled-artifacts.d.ts

@@ -0,0 +1,23 @@
+import type { CompileAgentResult } from "../../compiler/compile-agent.js";
+/**
+ * Stable directory name used to stage compiled `workspace/` artifacts beside
+ * bundled workflow entrypoints.
+ */
+export declare const BUNDLED_WORKSPACE_DIRECTORY_NAME = "compiled-workspace";
+/**
+ * Paths to the generated compiled-artifacts files shared by Nitro and the
+ * vendored workflow bundles for one application.
+ */
+export interface GeneratedCompiledArtifactsFiles {
+    bootstrapPath: string;
+    nitroPluginPath: string;
+}
+/**
+ * Writes the generated compiled-artifacts bootstrap plus the Nitro plugin that
+ * imports it.
+ */
+export declare function writeCompiledArtifactsFiles(input: {
+    compileResult: CompileAgentResult;
+    outDir: string;
+}): Promise<GeneratedCompiledArtifactsFiles>;
+//# sourceMappingURL=compiled-artifacts.d.ts.map

package/dist/src/internal/application/compiled-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiled-artifacts.d.ts","sourceRoot":"","sources":["../../../../src/internal/application/compiled-artifacts.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAS1E;;;GAGG;AACH,eAAO,MAAM,gCAAgC,uBAAuB,CAAC;AAErE;;;GAGG;AACH,MAAM,WAAW,+BAA+B;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAAC,KAAK,EAAE;IACvD,aAAa,EAAE,kBAAkB,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,+BAA+B,CAAC,CA0C3C"}