experimental-ash 0.1.0-alpha.1

package/dist/src/discover/manifest.js

@@ -0,0 +1,155 @@
+import { basename, relative, resolve } from "node:path";
+import { summarizeDiscoverDiagnostics } from "./diagnostics.js";
+import { normalizeLogicalPath } from "./filesystem.js";
+/**
+ * Stable manifest kind emitted by discovery.
+ */
+export const AGENT_SOURCE_MANIFEST_KIND = "ash-agent-discovery-manifest";
+/**
+ * Current manifest schema version.
+ */
+export const AGENT_SOURCE_MANIFEST_VERSION = 3;
+/**
+ * Creates a versioned discovery manifest with stable empty-array defaults.
+ */
+export function createAgentSourceManifest(input) {
+    const appRoot = resolve(input.appRoot);
+    const agentRoot = resolve(input.agentRoot);
+    const manifest = {
+        agentId: input.agentId ?? deriveAgentIdFromRoots(appRoot, agentRoot),
+        agentRoot,
+        appRoot,
+        context: [...(input.context ?? [])],
+        diagnosticsSummary: summarizeDiscoverDiagnostics(input.diagnostics ?? []),
+        lib: [...(input.lib ?? [])],
+        kind: AGENT_SOURCE_MANIFEST_KIND,
+        sandboxes: [...(input.sandboxes ?? [])],
+        schedules: [...(input.schedules ?? [])],
+        skills: [...(input.skills ?? [])],
+        tools: [...(input.tools ?? [])],
+        version: AGENT_SOURCE_MANIFEST_VERSION,
+        workspace: [...(input.workspace ?? [])],
+        subagents: [...(input.subagents ?? [])],
+    };
+    if (input.configModule !== undefined) {
+        manifest.configModule = input.configModule;
+    }
+    if (input.system !== undefined) {
+        manifest.system = input.system;
+    }
+    if (input.subagentModule !== undefined) {
+        manifest.subagentModule = input.subagentModule;
+    }
+    return manifest;
+}
+/**
+ * Derives a stable agent id from the resolved app and agent roots.
+ */
+export function deriveAgentIdFromRoots(appRoot, agentRoot) {
+    const relativeAgentRoot = normalizeLogicalPath(relative(appRoot, agentRoot));
+    if (relativeAgentRoot === "" || relativeAgentRoot === ".") {
+        return basename(appRoot);
+    }
+    if (relativeAgentRoot === "agent") {
+        return basename(appRoot);
+    }
+    return basename(agentRoot);
+}
+/**
+ * Creates a stable path-derived source id for manifest entries.
+ */
+export function createPathDerivedSourceId(logicalPath) {
+    return normalizeLogicalPath(logicalPath);
+}
+/**
+ * Creates a module source ref while omitting optional undefined fields.
+ */
+export function createModuleSourceRef(input) {
+    const logicalPath = normalizeLogicalPath(input.logicalPath);
+    const moduleSourceRef = {
+        kind: "module",
+        logicalPath,
+        sourceId: input.sourceId ?? createPathDerivedSourceId(logicalPath),
+    };
+    if (input.exportName !== undefined) {
+        moduleSourceRef.exportName = input.exportName;
+    }
+    return moduleSourceRef;
+}
+/**
+ * Creates a file-backed context source ref while omitting optional undefined
+ * fields.
+ */
+export function createContextFileSourceRef(input) {
+    const logicalPath = normalizeLogicalPath(input.logicalPath);
+    return {
+        byteSize: input.byteSize,
+        kind: "context-file",
+        logicalPath,
+        mediaType: input.mediaType,
+        sourceId: input.sourceId ?? createPathDerivedSourceId(logicalPath),
+    };
+}
+/**
+ * Creates a workspace file source ref while omitting optional undefined
+ * fields.
+ */
+export function createWorkspaceFileSourceRef(input) {
+    const logicalPath = normalizeLogicalPath(input.logicalPath);
+    return {
+        byteSize: input.byteSize,
+        kind: "workspace-file",
+        logicalPath,
+        sourceId: input.sourceId ?? createPathDerivedSourceId(logicalPath),
+    };
+}
+/**
+ * Creates a local subagent source ref while omitting optional undefined fields.
+ */
+export function createLocalSubagentSourceRef(input) {
+    const logicalPath = normalizeLogicalPath(input.logicalPath);
+    return {
+        entryPath: input.entryPath,
+        logicalPath,
+        manifest: input.manifest,
+        rootPath: input.rootPath,
+        sourceId: input.sourceId ?? createPathDerivedSourceId(logicalPath),
+        subagentId: input.subagentId,
+    };
+}
+/**
+ * Creates a skill package source ref while omitting optional undefined fields.
+ */
+export function createSkillPackageSourceRef(input) {
+    const skillSourceRef = {
+        description: input.description,
+        kind: "skill-package",
+        logicalPath: normalizeLogicalPath(input.logicalPath),
+        markdown: input.markdown,
+        name: input.name,
+        rootPath: input.rootPath,
+        skillFilePath: input.skillFilePath,
+        skillId: input.skillId,
+        sourceId: input.sourceId,
+    };
+    if (input.assetsPath !== undefined) {
+        skillSourceRef.assetsPath = input.assetsPath;
+    }
+    if (input.compatibility !== undefined) {
+        skillSourceRef.compatibility = input.compatibility;
+    }
+    if (input.license !== undefined) {
+        skillSourceRef.license = input.license;
+    }
+    if (input.metadata !== undefined) {
+        skillSourceRef.metadata = { ...input.metadata };
+    }
+    if (input.referencesPath !== undefined) {
+        skillSourceRef.referencesPath = input.referencesPath;
+    }
+    if (input.scriptsPath !== undefined) {
+        skillSourceRef.scriptsPath = input.scriptsPath;
+    }
+    return skillSourceRef;
+}
+//# sourceMappingURL=manifest.js.map

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

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

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

@@ -0,0 +1,17 @@
+import type { MarkdownSourceRef } from "../internal/source-ref.js";
+/**
+ * Input for lowering one discovered markdown file into a typed source ref.
+ */
+export interface DiscoverMarkdownSourceInput<TDefinition> {
+    logicalPath: string;
+    lower: (source: string, input: {
+        id: string;
+    }) => TDefinition;
+    sourcePath: string;
+}
+/**
+ * Reads one markdown-authored source from disk and lowers it into the shared
+ * manifest shape.
+ */
+export declare function discoverMarkdownSource<TDefinition>(input: DiscoverMarkdownSourceInput<TDefinition>): Promise<MarkdownSourceRef<TDefinition>>;
+//# sourceMappingURL=markdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../../src/discover/markdown.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAInE;;GAEG;AACH,MAAM,WAAW,2BAA2B,CAAC,WAAW;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,KAAK,WAAW,CAAC;IAC9D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,WAAW,EACtD,KAAK,EAAE,2BAA2B,CAAC,WAAW,CAAC,GAC9C,OAAO,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAWzC"}

package/dist/src/discover/markdown.js

@@ -0,0 +1,19 @@
+import { readFile } from "node:fs/promises";
+import { normalizeLogicalPath, stripLogicalPathExtension } from "./filesystem.js";
+import { createPathDerivedSourceId } from "./manifest.js";
+/**
+ * Reads one markdown-authored source from disk and lowers it into the shared
+ * manifest shape.
+ */
+export async function discoverMarkdownSource(input) {
+    const logicalPath = normalizeLogicalPath(input.logicalPath);
+    return {
+        definition: input.lower(await readFile(input.sourcePath, "utf8"), {
+            id: stripLogicalPathExtension(logicalPath),
+        }),
+        kind: "markdown",
+        logicalPath,
+        sourceId: createPathDerivedSourceId(logicalPath),
+    };
+}
+//# sourceMappingURL=markdown.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../../src/discover/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAW1D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,KAA+C;IAE/C,MAAM,WAAW,GAAG,oBAAoB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAE5D,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE;YAChE,EAAE,EAAE,yBAAyB,CAAC,WAAW,CAAC;SAC3C,CAAC;QACF,IAAI,EAAE,UAAU;QAChB,WAAW;QACX,QAAQ,EAAE,yBAAyB,CAAC,WAAW,CAAC;KACjD,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,25 @@
+import { type DiscoverDiagnostic } from "./diagnostics.js";
+/**
+ * Supported project layouts for filesystem-based agents.
+ */
+export type DiscoveryProjectLayout = "flat" | "nested";
+/**
+ * Resolved discovery roots for the current application.
+ */
+export interface ResolvedDiscoveryProject {
+    agentRoot: string;
+    appRoot: string;
+    layout: DiscoveryProjectLayout;
+}
+/**
+ * Error raised when discovery cannot resolve an Ash agent root from disk.
+ */
+export declare class DiscoveryProjectResolutionError extends Error {
+    readonly diagnostic: DiscoverDiagnostic;
+    constructor(diagnostic: DiscoverDiagnostic);
+}
+/**
+ * Resolves the nearest Ash app root and agent root from an arbitrary starting path.
+ */
+export declare function resolveDiscoveryProject(startPath?: string): Promise<ResolvedDiscoveryProject>;
+//# sourceMappingURL=project.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../src/discover/project.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAC;AAQ1B;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAED;;GAEG;AACH,qBAAa,+BAAgC,SAAQ,KAAK;IACxD,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;gBAE5B,UAAU,EAAE,kBAAkB;CAK3C;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,SAAS,GAAE,MAAsB,GAChC,OAAO,CAAC,wBAAwB,CAAC,CA0CnC"}

package/dist/src/discover/project.js

@@ -0,0 +1,115 @@
+import { readdir, stat } from "node:fs/promises";
+import { basename, dirname, join, resolve } from "node:path";
+import { createDiscoverErrorDiagnostic, DISCOVER_PROJECT_NOT_FOUND, } from "./diagnostics.js";
+import { classifyAgentRootEntry, getDirectoryEntryType, isProjectMarkerEntry, } from "./filesystem.js";
+/**
+ * Error raised when discovery cannot resolve an Ash agent root from disk.
+ */
+export class DiscoveryProjectResolutionError extends Error {
+    diagnostic;
+    constructor(diagnostic) {
+        super(diagnostic.message);
+        this.name = "DiscoveryProjectResolutionError";
+        this.diagnostic = diagnostic;
+    }
+}
+/**
+ * Resolves the nearest Ash app root and agent root from an arbitrary starting path.
+ */
+export async function resolveDiscoveryProject(startPath = process.cwd()) {
+    const startDirectory = await resolveSearchDirectory(startPath);
+    let currentDirectory = startDirectory;
+    while (true) {
+        const nestedProjectFromAgentDirectory = await tryResolveNestedProjectFromAgentDirectory(currentDirectory);
+        if (nestedProjectFromAgentDirectory !== null) {
+            return nestedProjectFromAgentDirectory;
+        }
+        const nestedProjectFromAppRoot = await tryResolveNestedProjectFromAppRoot(currentDirectory);
+        if (nestedProjectFromAppRoot !== null) {
+            return nestedProjectFromAppRoot;
+        }
+        if (await isFlatAgentRoot(currentDirectory)) {
+            return {
+                agentRoot: currentDirectory,
+                appRoot: currentDirectory,
+                layout: "flat",
+            };
+        }
+        const parentDirectory = dirname(currentDirectory);
+        if (parentDirectory === currentDirectory) {
+            break;
+        }
+        currentDirectory = parentDirectory;
+    }
+    throw new DiscoveryProjectResolutionError(createDiscoverErrorDiagnostic({
+        code: DISCOVER_PROJECT_NOT_FOUND,
+        message: `Could not resolve an Ash agent root from "${startDirectory}".`,
+        sourcePath: startDirectory,
+    }));
+}
+async function resolveSearchDirectory(startPath) {
+    const resolvedPath = resolve(startPath);
+    const stats = await stat(resolvedPath);
+    if (stats.isDirectory()) {
+        return resolvedPath;
+    }
+    return dirname(resolvedPath);
+}
+async function tryResolveNestedProjectFromAgentDirectory(directoryPath) {
+    if (basename(directoryPath) !== "agent") {
+        return null;
+    }
+    const parentDirectory = dirname(directoryPath);
+    if (!(await hasProjectMarkers(parentDirectory))) {
+        return null;
+    }
+    return {
+        agentRoot: directoryPath,
+        appRoot: parentDirectory,
+        layout: "nested",
+    };
+}
+async function tryResolveNestedProjectFromAppRoot(directoryPath) {
+    if (!(await hasProjectMarkers(directoryPath))) {
+        return null;
+    }
+    const agentDirectory = join(directoryPath, "agent");
+    if (!(await directoryExists(agentDirectory))) {
+        return null;
+    }
+    return {
+        agentRoot: agentDirectory,
+        appRoot: directoryPath,
+        layout: "nested",
+    };
+}
+async function isFlatAgentRoot(directoryPath) {
+    const entries = await readDirectoryEntryTypes(directoryPath);
+    return Array.from(entries.entries()).some(([name, entryType]) => {
+        const entryKind = classifyAgentRootEntry(name, entryType);
+        return entryKind !== "unknown" && entryKind !== "lib-directory";
+    });
+}
+async function hasProjectMarkers(directoryPath) {
+    const entries = await readDirectoryEntryTypes(directoryPath);
+    return Array.from(entries.entries()).some(([name, entryType]) => {
+        return isProjectMarkerEntry(name, entryType);
+    });
+}
+async function readDirectoryEntryTypes(directoryPath) {
+    const entries = await readdir(directoryPath, {
+        withFileTypes: true,
+    });
+    return new Map(entries.map((entry) => {
+        return [entry.name, getDirectoryEntryType(entry)];
+    }));
+}
+async function directoryExists(directoryPath) {
+    try {
+        return (await stat(directoryPath)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=project.js.map

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

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

package/dist/src/discover/resource-tree.d.ts

@@ -0,0 +1,18 @@
+import { type DiscoverDiagnostic } from "./diagnostics.js";
+/**
+ * Recursively walks one authored discovery tree and delegates file lowering to
+ * the provided file-entry callback.
+ */
+export declare function discoverResourceTree<T>(input: {
+    createFileEntry: (input: {
+        entryName: string;
+        logicalPath: string;
+        sourcePath: string;
+    }) => Promise<T>;
+    diagnostics: DiscoverDiagnostic[];
+    directoryPath: string;
+    logicalDirectoryPath: string;
+    unsupportedEntryCode: string;
+    unsupportedEntryDescription: string;
+}): Promise<T[]>;
+//# sourceMappingURL=resource-tree.d.ts.map

package/dist/src/discover/resource-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-tree.d.ts","sourceRoot":"","sources":["../../../src/discover/resource-tree.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiC,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAI1F;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,EAAE,KAAK,EAAE;IACnD,eAAe,EAAE,CAAC,KAAK,EAAE;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;KACpB,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACjB,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,2BAA2B,EAAE,MAAM,CAAC;CACrC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CA4Cf"}

package/dist/src/discover/resource-tree.js

@@ -0,0 +1,43 @@
+import { join } from "node:path";
+import { createDiscoverErrorDiagnostic } from "./diagnostics.js";
+import { getDirectoryEntryType, normalizeLogicalPath } from "./filesystem.js";
+import { readSortedDirectoryEntries } from "./grammar.js";
+/**
+ * Recursively walks one authored discovery tree and delegates file lowering to
+ * the provided file-entry callback.
+ */
+export async function discoverResourceTree(input) {
+    const entries = await readSortedDirectoryEntries(input.directoryPath);
+    const resources = [];
+    for (const entry of entries) {
+        const entryType = getDirectoryEntryType(entry);
+        const logicalPath = normalizeLogicalPath(join(input.logicalDirectoryPath, entry.name));
+        const sourcePath = join(input.directoryPath, entry.name);
+        if (entryType === "directory") {
+            resources.push(...(await discoverResourceTree({
+                createFileEntry: input.createFileEntry,
+                diagnostics: input.diagnostics,
+                directoryPath: sourcePath,
+                logicalDirectoryPath: logicalPath,
+                unsupportedEntryCode: input.unsupportedEntryCode,
+                unsupportedEntryDescription: input.unsupportedEntryDescription,
+            })));
+            continue;
+        }
+        if (entryType === "file") {
+            resources.push(await input.createFileEntry({
+                entryName: entry.name,
+                logicalPath,
+                sourcePath,
+            }));
+            continue;
+        }
+        input.diagnostics.push(createDiscoverErrorDiagnostic({
+            code: input.unsupportedEntryCode,
+            message: `Expected "${sourcePath}" to be a regular file or directory within "${input.unsupportedEntryDescription}/".`,
+            sourcePath,
+        }));
+    }
+    return resources;
+}
+//# sourceMappingURL=resource-tree.js.map

package/dist/src/discover/resource-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-tree.js","sourceRoot":"","sources":["../../../src/discover/resource-tree.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,6BAA6B,EAA2B,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAE1D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAI,KAW7C;IACC,MAAM,OAAO,GAAG,MAAM,0BAA0B,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACtE,MAAM,SAAS,GAAQ,EAAE,CAAC;IAE1B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,WAAW,GAAG,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,oBAAoB,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACvF,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAEzD,IAAI,SAAS,KAAK,WAAW,EAAE,CAAC;YAC9B,SAAS,CAAC,IAAI,CACZ,GAAG,CAAC,MAAM,oBAAoB,CAAC;gBAC7B,eAAe,EAAE,KAAK,CAAC,eAAe;gBACtC,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,aAAa,EAAE,UAAU;gBACzB,oBAAoB,EAAE,WAAW;gBACjC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;gBAChD,2BAA2B,EAAE,KAAK,CAAC,2BAA2B;aAC/D,CAAC,CAAC,CACJ,CAAC;YACF,SAAS;QACX,CAAC;QAED,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;YACzB,SAAS,CAAC,IAAI,CACZ,MAAM,KAAK,CAAC,eAAe,CAAC;gBAC1B,SAAS,EAAE,KAAK,CAAC,IAAI;gBACrB,WAAW;gBACX,UAAU;aACX,CAAC,CACH,CAAC;YACF,SAAS;QACX,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,IAAI,CACpB,6BAA6B,CAAC;YAC5B,IAAI,EAAE,KAAK,CAAC,oBAAoB;YAChC,OAAO,EAAE,aAAa,UAAU,+CAA+C,KAAK,CAAC,2BAA2B,KAAK;YACrH,UAAU;SACX,CAAC,CACH,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

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

@@ -0,0 +1,32 @@
+import { type DiscoverDiagnostic } from "./diagnostics.js";
+import { type SkillSourceRef } from "./manifest.js";
+/**
+ * Diagnostics emitted by skill discovery.
+ */
+export declare const DISCOVER_SKILLS_DIRECTORY_INVALID = "discover/skills-directory-invalid";
+export declare const DISCOVER_SKILL_COLLISION = "discover/skill-collision";
+export declare const DISCOVER_SKILL_ENTRY_NOT_DIRECTORY = "discover/skill-entry-not-directory";
+export declare const DISCOVER_SKILL_FRONTMATTER_INVALID = "discover/skill-frontmatter-invalid";
+export declare const DISCOVER_SKILL_MARKDOWN_MISSING = "discover/skill-markdown-missing";
+export declare const DISCOVER_SKILL_NAME_MISMATCH = "discover/skill-name-mismatch";
+/**
+ * Input for discovering authored skills.
+ */
+export interface DiscoverSkillsInput {
+    agentRoot: string;
+    skillsDirectoryPath?: string;
+    skillsLogicalPath?: string;
+}
+/**
+ * Result of discovering authored skills.
+ */
+export interface DiscoverSkillsResult {
+    diagnostics: DiscoverDiagnostic[];
+    skills: SkillSourceRef[];
+}
+/**
+ * Discovers authored skills from either flat `skills/<name>.md|ts|js|mjs`
+ * entries or Agent Skills packages rooted at `skills/<name>/SKILL.md`.
+ */
+export declare function discoverSkills(input: DiscoverSkillsInput): Promise<DiscoverSkillsResult>;
+//# sourceMappingURL=skills.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/discover/skills.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiC,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAQ1F,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AAEvB;;GAEG;AACH,eAAO,MAAM,iCAAiC,sCAAsC,CAAC;AACrF,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AACnE,eAAO,MAAM,kCAAkC,uCAAuC,CAAC;AACvF,eAAO,MAAM,kCAAkC,uCAAuC,CAAC;AACvF,eAAO,MAAM,+BAA+B,oCAAoC,CAAC;AACjF,eAAO,MAAM,4BAA4B,iCAAiC,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAoF9F"}