experimental-ash 0.1.0-alpha.1

package/dist/src/discover/context.js

@@ -0,0 +1,88 @@
+import { stat } from "node:fs/promises";
+import { extname, join } from "node:path";
+import { createDiscoverErrorDiagnostic } from "./diagnostics.js";
+import { getSupportedModuleBaseName } from "./filesystem.js";
+import { createContextFileSourceRef, createModuleSourceRef, } from "./manifest.js";
+import { discoverResourceTree } from "./resource-tree.js";
+/**
+ * Diagnostic emitted when the authored `context/` root exists but is not a
+ * directory.
+ */
+export const DISCOVER_CONTEXT_DIRECTORY_INVALID = "discover/context-directory-invalid";
+/**
+ * Diagnostic emitted when discovery finds an unsupported non-file entry under
+ * the authored `context/` tree.
+ */
+export const DISCOVER_CONTEXT_ENTRY_UNSUPPORTED = "discover/context-entry-unsupported";
+/**
+ * Discovers file-backed and module-backed resources under `context/` without
+ * executing any authored modules.
+ */
+export async function discoverContextSources(input) {
+    const contextRoot = join(input.agentRoot, "context");
+    const contextDirectoryEntry = input.rootEntries.find((entry) => entry.name === "context");
+    if (contextDirectoryEntry === undefined) {
+        return {
+            context: [],
+            diagnostics: [],
+        };
+    }
+    if (!contextDirectoryEntry.isDirectory()) {
+        return {
+            context: [],
+            diagnostics: [
+                createDiscoverErrorDiagnostic({
+                    code: DISCOVER_CONTEXT_DIRECTORY_INVALID,
+                    message: `Expected "${contextRoot}" to be a directory of authored context resources.`,
+                    sourcePath: contextRoot,
+                }),
+            ],
+        };
+    }
+    const diagnostics = [];
+    const context = await discoverResourceTree({
+        async createFileEntry({ entryName, logicalPath, sourcePath }) {
+            if (getSupportedModuleBaseName(entryName) !== null) {
+                return createModuleSourceRef({
+                    logicalPath,
+                });
+            }
+            const entryStat = await stat(sourcePath);
+            return createContextFileSourceRef({
+                byteSize: entryStat.size,
+                logicalPath,
+                mediaType: inferContextMediaType(logicalPath),
+            });
+        },
+        diagnostics,
+        directoryPath: contextRoot,
+        logicalDirectoryPath: "context",
+        unsupportedEntryCode: DISCOVER_CONTEXT_ENTRY_UNSUPPORTED,
+        unsupportedEntryDescription: "context",
+    });
+    return {
+        context,
+        diagnostics,
+    };
+}
+function inferContextMediaType(logicalPath) {
+    switch (extname(logicalPath).toLowerCase()) {
+        case ".json":
+            return "application/json";
+        case ".md":
+        case ".mdx":
+            return "text/markdown";
+        case ".yaml":
+        case ".yml":
+            return "application/yaml";
+        case ".csv":
+            return "text/csv";
+        case ".html":
+            return "text/html";
+        case ".xml":
+            return "application/xml";
+        default:
+            return "text/plain";
+    }
+}
+//# sourceMappingURL=context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/discover/context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,6BAA6B,EAA2B,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAEL,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;;GAGG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,oCAAoC,CAAC;AAEvF;;;GAGG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,oCAAoC,CAAC;AAoBvF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,KAAkC;IAElC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACrD,MAAM,qBAAqB,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAE1F,IAAI,qBAAqB,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO;YACL,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,EAAE;SAChB,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,qBAAqB,CAAC,WAAW,EAAE,EAAE,CAAC;QACzC,OAAO;YACL,OAAO,EAAE,EAAE;YACX,WAAW,EAAE;gBACX,6BAA6B,CAAC;oBAC5B,IAAI,EAAE,kCAAkC;oBACxC,OAAO,EAAE,aAAa,WAAW,oDAAoD;oBACrF,UAAU,EAAE,WAAW;iBACxB,CAAC;aACH;SACF,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAyB,EAAE,CAAC;IAC7C,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC;QACzC,KAAK,CAAC,eAAe,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE;YAC1D,IAAI,0BAA0B,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC;gBACnD,OAAO,qBAAqB,CAAC;oBAC3B,WAAW;iBACZ,CAAC,CAAC;YACL,CAAC;YAED,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC;YAEzC,OAAO,0BAA0B,CAAC;gBAChC,QAAQ,EAAE,SAAS,CAAC,IAAI;gBACxB,WAAW;gBACX,SAAS,EAAE,qBAAqB,CAAC,WAAW,CAAC;aAC9C,CAAC,CAAC;QACL,CAAC;QACD,WAAW;QACX,aAAa,EAAE,WAAW;QAC1B,oBAAoB,EAAE,SAAS;QAC/B,oBAAoB,EAAE,kCAAkC;QACxD,2BAA2B,EAAE,SAAS;KACvC,CAAC,CAAC;IAEH,OAAO;QACL,OAAO;QACP,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,WAAmB;IAChD,QAAQ,OAAO,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QAC3C,KAAK,OAAO;YACV,OAAO,kBAAkB,CAAC;QAC5B,KAAK,KAAK,CAAC;QACX,KAAK,MAAM;YACT,OAAO,eAAe,CAAC;QACzB,KAAK,OAAO,CAAC;QACb,KAAK,MAAM;YACT,OAAO,kBAAkB,CAAC;QAC5B,KAAK,MAAM;YACT,OAAO,UAAU,CAAC;QACpB,KAAK,OAAO;YACV,OAAO,WAAW,CAAC;QACrB,KAAK,MAAM;YACT,OAAO,iBAAiB,CAAC;QAC3B;YACE,OAAO,YAAY,CAAC;IACxB,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,74 @@
+import { z } from "zod";
+/**
+ * Structured discovery diagnostic severity.
+ */
+export type DiscoverDiagnosticSeverity = "error" | "warning";
+/**
+ * Zod schema for structured discovery diagnostic severities.
+ */
+export declare const discoverDiagnosticSeveritySchema: z.ZodType<DiscoverDiagnosticSeverity>;
+/**
+ * Structured discovery diagnostic emitted while classifying authored sources.
+ */
+export interface DiscoverDiagnostic {
+    /**
+     * Stable machine-readable diagnostic code.
+     */
+    code: string;
+    /**
+     * Human-readable diagnostic message.
+     */
+    message: string;
+    /**
+     * Discovery severity.
+     */
+    severity: DiscoverDiagnosticSeverity;
+    /**
+     * Absolute source path associated with the diagnostic.
+     */
+    sourcePath: string;
+}
+/**
+ * Zod schema for one structured discovery diagnostic.
+ */
+export declare const discoverDiagnosticSchema: z.ZodType<DiscoverDiagnostic>;
+/**
+ * Summary counts emitted alongside discovery manifests and CLI output.
+ */
+export interface DiscoverDiagnosticsSummary {
+    errors: number;
+    warnings: number;
+}
+/**
+ * Zod schema for discovery diagnostic summary counts.
+ */
+export declare const discoverDiagnosticsSummarySchema: z.ZodType<DiscoverDiagnosticsSummary>;
+/**
+ * Root-resolution error code emitted when discovery cannot locate an Ash agent.
+ */
+export declare const DISCOVER_PROJECT_NOT_FOUND = "discover/project-not-found";
+/**
+ * Creates a structured discovery diagnostic.
+ */
+export declare function createDiscoverDiagnostic(input: DiscoverDiagnostic): DiscoverDiagnostic;
+/**
+ * Creates an error-level discovery diagnostic.
+ */
+export declare function createDiscoverErrorDiagnostic(input: Omit<DiscoverDiagnostic, "severity">): DiscoverDiagnostic;
+/**
+ * Creates a warning-level discovery diagnostic.
+ */
+export declare function createDiscoverWarningDiagnostic(input: Omit<DiscoverDiagnostic, "severity">): DiscoverDiagnostic;
+/**
+ * Returns whether an unknown value satisfies the discovery diagnostic shape.
+ */
+export declare function isDiscoverDiagnostic(value: unknown): value is DiscoverDiagnostic;
+/**
+ * Summarizes discovery diagnostics into error and warning counts.
+ */
+export declare function summarizeDiscoverDiagnostics(diagnostics: readonly DiscoverDiagnostic[]): DiscoverDiagnosticsSummary;
+/**
+ * Returns whether discovery diagnostics include at least one error.
+ */
+export declare function hasDiscoverErrors(diagnostics: readonly DiscoverDiagnostic[]): boolean;
+//# sourceMappingURL=diagnostics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../src/discover/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,OAAO,GAAG,SAAS,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,gCAAgC,EAAE,CAAC,CAAC,OAAO,CAAC,0BAA0B,CAGjF,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,QAAQ,EAAE,0BAA0B,CAAC;IACrC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAmBxD,CAAC;AAEZ;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,gCAAgC,EAAE,CAAC,CAAC,OAAO,CAAC,0BAA0B,CAKxE,CAAC;AAEZ;;GAEG;AACH,eAAO,MAAM,0BAA0B,+BAA+B,CAAC;AAEvE;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,kBAAkB,GAAG,kBAAkB,CAEtF;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,GAC1C,kBAAkB,CAKpB;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,GAC1C,kBAAkB,CAKpB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAEhF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,SAAS,kBAAkB,EAAE,GACzC,0BAA0B,CAgB5B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,GAAG,OAAO,CAErF"}

package/dist/src/discover/diagnostics.js

@@ -0,0 +1,98 @@
+import { z } from "zod";
+/**
+ * Zod schema for structured discovery diagnostic severities.
+ */
+export const discoverDiagnosticSeveritySchema = z.union([
+    z.literal("error"),
+    z.literal("warning"),
+]);
+/**
+ * Zod schema for one structured discovery diagnostic.
+ */
+export const discoverDiagnosticSchema = z
+    .object({
+    /**
+     * Stable machine-readable diagnostic code.
+     */
+    code: z.string(),
+    /**
+     * Human-readable diagnostic message.
+     */
+    message: z.string(),
+    /**
+     * Discovery severity.
+     */
+    severity: discoverDiagnosticSeveritySchema,
+    /**
+     * Absolute source path associated with the diagnostic.
+     */
+    sourcePath: z.string(),
+})
+    .strict();
+/**
+ * Zod schema for discovery diagnostic summary counts.
+ */
+export const discoverDiagnosticsSummarySchema = z
+    .object({
+    errors: z.number().finite(),
+    warnings: z.number().finite(),
+})
+    .strict();
+/**
+ * Root-resolution error code emitted when discovery cannot locate an Ash agent.
+ */
+export const DISCOVER_PROJECT_NOT_FOUND = "discover/project-not-found";
+/**
+ * Creates a structured discovery diagnostic.
+ */
+export function createDiscoverDiagnostic(input) {
+    return input;
+}
+/**
+ * Creates an error-level discovery diagnostic.
+ */
+export function createDiscoverErrorDiagnostic(input) {
+    return createDiscoverDiagnostic({
+        ...input,
+        severity: "error",
+    });
+}
+/**
+ * Creates a warning-level discovery diagnostic.
+ */
+export function createDiscoverWarningDiagnostic(input) {
+    return createDiscoverDiagnostic({
+        ...input,
+        severity: "warning",
+    });
+}
+/**
+ * Returns whether an unknown value satisfies the discovery diagnostic shape.
+ */
+export function isDiscoverDiagnostic(value) {
+    return discoverDiagnosticSchema.safeParse(value).success;
+}
+/**
+ * Summarizes discovery diagnostics into error and warning counts.
+ */
+export function summarizeDiscoverDiagnostics(diagnostics) {
+    return diagnostics.reduce((summary, diagnostic) => {
+        if (diagnostic.severity === "error") {
+            summary.errors += 1;
+        }
+        else {
+            summary.warnings += 1;
+        }
+        return summary;
+    }, {
+        errors: 0,
+        warnings: 0,
+    });
+}
+/**
+ * Returns whether discovery diagnostics include at least one error.
+ */
+export function hasDiscoverErrors(diagnostics) {
+    return diagnostics.some((diagnostic) => diagnostic.severity === "error");
+}
+//# sourceMappingURL=diagnostics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../../src/discover/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB;;GAEG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAA0C,CAAC,CAAC,KAAK,CAAC;IAC7F,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IAClB,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;CACrB,CAAC,CAAC;AAwBH;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAkC,CAAC;KACrE,MAAM,CAAC;IACN;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB;;OAEG;IACH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB;;OAEG;IACH,QAAQ,EAAE,gCAAgC;IAC1C;;OAEG;IACH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC;KACD,MAAM,EAAE,CAAC;AAUZ;;GAEG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAA0C,CAAC;KACrF,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE;CAC9B,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,4BAA4B,CAAC;AAEvE;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAyB;IAChE,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAA2C;IAE3C,OAAO,wBAAwB,CAAC;QAC9B,GAAG,KAAK;QACR,QAAQ,EAAE,OAAO;KAClB,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAC7C,KAA2C;IAE3C,OAAO,wBAAwB,CAAC;QAC9B,GAAG,KAAK;QACR,QAAQ,EAAE,SAAS;KACpB,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,wBAAwB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAC1C,WAA0C;IAE1C,OAAO,WAAW,CAAC,MAAM,CACvB,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE;QACtB,IAAI,UAAU,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACpC,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;QACxB,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC,EACD;QACE,MAAM,EAAE,CAAC;QACT,QAAQ,EAAE,CAAC;KACZ,CACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAA0C;IAC1E,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;AAC3E,CAAC"}

package/dist/src/discover/discover-agent.d.ts

@@ -0,0 +1,29 @@
+import { type DiscoverDiagnostic } from "./diagnostics.js";
+import { DISCOVER_LEGACY_MEMORIES_DIRECTORY_UNSUPPORTED, DISCOVER_MODULE_SLOT_COLLISION, DISCOVER_REQUIRED_SYSTEM_MISSING, DISCOVER_SANDBOXES_DIRECTORY_INVALID, DISCOVER_SLOT_COLLISION, DISCOVER_TOOLS_DIRECTORY_INVALID, DISCOVER_UNSUPPORTED_DIRECTORY } from "./grammar.js";
+import { type AgentSourceManifest } from "./manifest.js";
+/**
+ * Diagnostics emitted while discovering the non-skill core authored agent
+ * grammar.
+ */
+export { DISCOVER_LEGACY_MEMORIES_DIRECTORY_UNSUPPORTED, DISCOVER_MODULE_SLOT_COLLISION, DISCOVER_REQUIRED_SYSTEM_MISSING, DISCOVER_SANDBOXES_DIRECTORY_INVALID, DISCOVER_SLOT_COLLISION, DISCOVER_TOOLS_DIRECTORY_INVALID, DISCOVER_UNSUPPORTED_DIRECTORY, };
+export declare const DISCOVER_SCHEDULES_DIRECTORY_INVALID = "discover/schedules-directory-invalid";
+/**
+ * Input for discovering the authored agent source graph from resolved roots.
+ */
+export interface DiscoverAgentInput {
+    agentRoot: string;
+    appRoot: string;
+}
+/**
+ * Result of discovering one authored agent source graph.
+ */
+export interface DiscoverAgentResult {
+    diagnostics: DiscoverDiagnostic[];
+    manifest: AgentSourceManifest;
+}
+/**
+ * Discovers the current agent's authored source graph without importing authored
+ * modules.
+ */
+export declare function discoverAgent(input: DiscoverAgentInput): Promise<DiscoverAgentResult>;
+//# sourceMappingURL=discover-agent.d.ts.map

package/dist/src/discover/discover-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-agent.d.ts","sourceRoot":"","sources":["../../../src/discover/discover-agent.ts"],"names":[],"mappings":"AAMA,OAAO,EAAiC,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAG1F,OAAO,EAIL,8CAA8C,EAC9C,8BAA8B,EAC9B,gCAAgC,EAChC,oCAAoC,EACpC,uBAAuB,EACvB,gCAAgC,EAChC,8BAA8B,EAM/B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,KAAK,mBAAmB,EAIzB,MAAM,eAAe,CAAC;AAMvB;;;GAGG;AACH,OAAO,EACL,8CAA8C,EAC9C,8BAA8B,EAC9B,gCAAgC,EAChC,oCAAoC,EACpC,uBAAuB,EACvB,gCAAgC,EAChC,8BAA8B,GAC/B,CAAC;AAEF,eAAO,MAAM,oCAAoC,yCAAyC,CAAC;AAE3F;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,QAAQ,EAAE,mBAAmB,CAAC;CAC/B;AAID;;;GAGG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA4G3F"}

package/dist/src/discover/discover-agent.js

@@ -0,0 +1,175 @@
+import { join, resolve } from "node:path";
+import { lowerScheduleMarkdown } from "../public/helpers/markdown.js";
+import { discoverContextSources } from "./context.js";
+import { createDiscoverErrorDiagnostic } from "./diagnostics.js";
+import { discoverSubagents } from "./discover-subagent.js";
+import { classifyAgentRootEntry, normalizeLogicalPath } from "./filesystem.js";
+import { createModuleSlotCollisionDiagnostic, createSlotCollisionDiagnostic, createUnsupportedRootDirectoryDiagnostics, DISCOVER_LEGACY_MEMORIES_DIRECTORY_UNSUPPORTED, DISCOVER_MODULE_SLOT_COLLISION, DISCOVER_REQUIRED_SYSTEM_MISSING, DISCOVER_SANDBOXES_DIRECTORY_INVALID, DISCOVER_SLOT_COLLISION, DISCOVER_TOOLS_DIRECTORY_INVALID, DISCOVER_UNSUPPORTED_DIRECTORY, discoverFlatModuleSource, discoverNamedModuleDirectorySources, discoverSystemSource, readSortedDirectoryEntries, } from "./grammar.js";
+import { discoverLibSources } from "./lib.js";
+import { createAgentSourceManifest, createModuleSourceRef, } from "./manifest.js";
+import { discoverMarkdownSource } from "./markdown.js";
+import { discoverSkills } from "./skills.js";
+import { collectNamedSlotCandidates } from "./slots.js";
+import { discoverWorkspaceSources } from "./workspace.js";
+/**
+ * Diagnostics emitted while discovering the non-skill core authored agent
+ * grammar.
+ */
+export { DISCOVER_LEGACY_MEMORIES_DIRECTORY_UNSUPPORTED, DISCOVER_MODULE_SLOT_COLLISION, DISCOVER_REQUIRED_SYSTEM_MISSING, DISCOVER_SANDBOXES_DIRECTORY_INVALID, DISCOVER_SLOT_COLLISION, DISCOVER_TOOLS_DIRECTORY_INVALID, DISCOVER_UNSUPPORTED_DIRECTORY, };
+export const DISCOVER_SCHEDULES_DIRECTORY_INVALID = "discover/schedules-directory-invalid";
+/**
+ * Discovers the current agent's authored source graph without importing authored
+ * modules.
+ */
+export async function discoverAgent(input) {
+    const appRoot = resolve(input.appRoot);
+    const agentRoot = resolve(input.agentRoot);
+    const diagnostics = [];
+    const rootEntries = await readSortedDirectoryEntries(agentRoot);
+    diagnostics.push(...createUnsupportedRootDirectoryDiagnostics({
+        classifyEntry: classifyAgentRootEntry,
+        createUnsupportedDirectoryMessage(directoryName) {
+            return `Ignoring unsupported directory "${directoryName}/" in the agent root.`;
+        },
+        rootEntries,
+        rootPath: agentRoot,
+    }));
+    const systemResult = await discoverSystemSource({
+        rootEntries,
+        rootPath: agentRoot,
+    });
+    diagnostics.push(...systemResult.diagnostics);
+    const configModuleResult = discoverFlatModuleSource({
+        rootEntries,
+        rootPath: agentRoot,
+        slotName: "agent",
+    });
+    diagnostics.push(...configModuleResult.diagnostics);
+    const contextResult = await discoverContextSources({
+        agentRoot,
+        rootEntries,
+    });
+    diagnostics.push(...contextResult.diagnostics);
+    const libResult = await discoverLibSources({
+        agentRoot,
+        rootEntries,
+    });
+    diagnostics.push(...libResult.diagnostics);
+    const schedulesResult = await discoverScheduleSources(agentRoot, rootEntries);
+    diagnostics.push(...schedulesResult.diagnostics);
+    const sandboxesResult = await discoverNamedModuleDirectorySources({
+        directoryName: "sandboxes",
+        invalidDirectoryCode: DISCOVER_SANDBOXES_DIRECTORY_INVALID,
+        invalidDirectoryMessage: `Expected "${join(agentRoot, "sandboxes")}" to be a directory of authored sandboxes.`,
+        rootEntries,
+        rootPath: agentRoot,
+    });
+    diagnostics.push(...sandboxesResult.diagnostics);
+    const toolsResult = await discoverNamedModuleDirectorySources({
+        directoryName: "tools",
+        invalidDirectoryCode: DISCOVER_TOOLS_DIRECTORY_INVALID,
+        invalidDirectoryMessage: `Expected "${join(agentRoot, "tools")}" to be a directory of authored tools.`,
+        rootEntries,
+        rootPath: agentRoot,
+    });
+    diagnostics.push(...toolsResult.diagnostics);
+    const skillsResult = await discoverSkills({
+        agentRoot,
+    });
+    diagnostics.push(...skillsResult.diagnostics);
+    const subagentsResult = await discoverSubagents({
+        agentRoot,
+        appRoot,
+    });
+    diagnostics.push(...subagentsResult.diagnostics);
+    const workspaceResult = await discoverWorkspaceSources({
+        agentRoot,
+        rootEntries,
+    });
+    diagnostics.push(...workspaceResult.diagnostics);
+    const manifestInput = {
+        agentRoot,
+        appRoot,
+        diagnostics,
+        context: contextResult.context,
+        lib: libResult.lib,
+        sandboxes: sandboxesResult.modules,
+        schedules: schedulesResult.schedules,
+        skills: skillsResult.skills,
+        tools: toolsResult.modules,
+        workspace: workspaceResult.workspace,
+        subagents: subagentsResult.subagents,
+    };
+    if (configModuleResult.module !== undefined) {
+        manifestInput.configModule = configModuleResult.module;
+    }
+    if (systemResult.system !== undefined) {
+        manifestInput.system = systemResult.system;
+    }
+    const manifest = createAgentSourceManifest(manifestInput);
+    return {
+        diagnostics,
+        manifest,
+    };
+}
+async function discoverScheduleSources(agentRoot, rootEntries) {
+    const schedulesRoot = join(agentRoot, "schedules");
+    const schedulesDirectoryEntry = rootEntries.find((entry) => entry.name === "schedules");
+    if (schedulesDirectoryEntry === undefined) {
+        return {
+            diagnostics: [],
+            schedules: [],
+        };
+    }
+    if (!schedulesDirectoryEntry.isDirectory()) {
+        return {
+            diagnostics: [
+                createDiscoverErrorDiagnostic({
+                    code: DISCOVER_SCHEDULES_DIRECTORY_INVALID,
+                    message: `Expected "${schedulesRoot}" to be a directory of authored schedules.`,
+                    sourcePath: schedulesRoot,
+                }),
+            ],
+            schedules: [],
+        };
+    }
+    const scheduleEntries = await readSortedDirectoryEntries(schedulesRoot);
+    const diagnostics = [];
+    const schedules = [];
+    for (const candidates of collectNamedSlotCandidates(scheduleEntries, {
+        allowMarkdown: true,
+        allowModules: true,
+    })) {
+        const scheduleSlotLogicalPath = normalizeLogicalPath(join("schedules", candidates.slotName));
+        if (candidates.markdownFileName !== undefined && candidates.moduleFileNames.length > 0) {
+            diagnostics.push(createSlotCollisionDiagnostic(schedulesRoot, scheduleSlotLogicalPath, [
+                candidates.markdownFileName,
+                ...candidates.moduleFileNames,
+            ]));
+            continue;
+        }
+        if (candidates.moduleFileNames.length > 1) {
+            diagnostics.push(createModuleSlotCollisionDiagnostic(schedulesRoot, scheduleSlotLogicalPath, candidates.moduleFileNames));
+            continue;
+        }
+        if (candidates.markdownFileName !== undefined) {
+            schedules.push(await discoverMarkdownSource({
+                logicalPath: join("schedules", candidates.markdownFileName),
+                lower: lowerScheduleMarkdown,
+                sourcePath: join(schedulesRoot, candidates.markdownFileName),
+            }));
+            continue;
+        }
+        const [logicalFileName] = candidates.moduleFileNames;
+        if (logicalFileName !== undefined) {
+            schedules.push(createModuleSourceRef({
+                logicalPath: join("schedules", logicalFileName),
+            }));
+        }
+    }
+    return {
+        diagnostics,
+        schedules,
+    };
+}
+//# sourceMappingURL=discover-agent.js.map

package/dist/src/discover/discover-agent.js.map

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

package/dist/src/discover/discover-subagent.d.ts

@@ -0,0 +1,31 @@
+import { type DiscoverDiagnostic } from "./diagnostics.js";
+import { type SubagentSourceRef } from "./manifest.js";
+/**
+ * Diagnostics emitted while discovering subagent source graphs.
+ */
+export declare const DISCOVER_LOCAL_SUBAGENT_SCHEDULES_INVALID = "discover/local-subagent-schedules-invalid";
+export declare const DISCOVER_REQUIRED_SUBAGENT_MODULE_MISSING = "discover/required-subagent-module-missing";
+export declare const DISCOVER_SUBAGENT_MODULE_UNSUPPORTED = "discover/subagent-module-unsupported";
+export declare const DISCOVER_SUBAGENTS_DIRECTORY_INVALID = "discover/subagents-directory-invalid";
+/**
+ * Input for discovering subagent entries beneath one authored source root.
+ */
+export interface DiscoverSubagentsInput {
+    agentRoot: string;
+    appRoot: string;
+    subagentsDirectoryPath?: string;
+    subagentsLogicalPath?: string;
+}
+/**
+ * Result of discovering local subagent packages.
+ */
+export interface DiscoverSubagentsResult {
+    diagnostics: DiscoverDiagnostic[];
+    subagents: SubagentSourceRef[];
+}
+/**
+ * Discovers local subagent packages recursively without importing authored
+ * modules.
+ */
+export declare function discoverSubagents(input: DiscoverSubagentsInput): Promise<DiscoverSubagentsResult>;
+//# sourceMappingURL=discover-subagent.d.ts.map

package/dist/src/discover/discover-subagent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-subagent.d.ts","sourceRoot":"","sources":["../../../src/discover/discover-subagent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiC,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAmB1F,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,eAAe,CAAC;AAGvB;;GAEG;AACH,eAAO,MAAM,yCAAyC,8CACT,CAAC;AAC9C,eAAO,MAAM,yCAAyC,8CACT,CAAC;AAC9C,eAAO,MAAM,oCAAoC,yCAAyC,CAAC;AAC3F,eAAO,MAAM,oCAAoC,yCAAyC,CAAC;AAE3F;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CAuElC"}