experimental-ash 0.1.0-alpha.1

package/dist/src/runtime/loaders/bundled-artifacts.d.ts

@@ -0,0 +1,35 @@
+import type { CompileMetadata } from "../../compiler/artifacts.js";
+import type { ContextResourcesArtifact } from "../../compiler/context.js";
+import type { CompiledAgentManifest } from "../../compiler/manifest.js";
+import type { CompiledModuleMap } from "../../compiler/module-map.js";
+import type { WorkspaceResourcesArtifact } from "../../compiler/workspace.js";
+/**
+ * Bundled compiled artifacts installed by Nitro when authored runtime state is
+ * embedded directly into the server bundle.
+ */
+export interface BundledCompiledArtifacts {
+    contextFiles: Readonly<Record<string, string>>;
+    contextResources: ContextResourcesArtifact;
+    manifest: CompiledAgentManifest;
+    metadata?: CompileMetadata;
+    moduleMap: CompiledModuleMap;
+    /**
+     * Runtime-resolved on-disk root containing bundled compiled `workspace/`
+     * seed files for step-owned harness mounts.
+     */
+    workspaceRootPath?: string;
+    workspaceResources: WorkspaceResourcesArtifact;
+}
+/**
+ * Installs one bundled compiled-artifact snapshot on the process-global object.
+ */
+export declare function installBundledCompiledArtifacts(input: BundledCompiledArtifacts): void;
+/**
+ * Clears the installed bundled compiled-artifact snapshot.
+ */
+export declare function resetBundledCompiledArtifacts(): void;
+/**
+ * Reads the bundled compiled-artifact snapshot when Nitro has installed one.
+ */
+export declare function readBundledCompiledArtifacts(): BundledCompiledArtifacts | null;
+//# sourceMappingURL=bundled-artifacts.d.ts.map

package/dist/src/runtime/loaders/bundled-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundled-artifacts.d.ts","sourceRoot":"","sources":["../../../../src/runtime/loaders/bundled-artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAQ9E;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,gBAAgB,EAAE,wBAAwB,CAAC;IAC3C,QAAQ,EAAE,qBAAqB,CAAC;IAChC,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,SAAS,EAAE,iBAAiB,CAAC;IAC7B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,0BAA0B,CAAC;CAChD;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,wBAAwB,GAAG,IAAI,CAIrF;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,IAAI,CAIpD;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,wBAAwB,GAAG,IAAI,CAM9E"}

package/dist/src/runtime/loaders/bundled-artifacts.js

@@ -0,0 +1,20 @@
+const BUNDLED_COMPILED_ARTIFACTS_KEY = "__ashBundledCompiledArtifacts";
+/**
+ * Installs one bundled compiled-artifact snapshot on the process-global object.
+ */
+export function installBundledCompiledArtifacts(input) {
+    globalThis[BUNDLED_COMPILED_ARTIFACTS_KEY] = input;
+}
+/**
+ * Clears the installed bundled compiled-artifact snapshot.
+ */
+export function resetBundledCompiledArtifacts() {
+    delete globalThis[BUNDLED_COMPILED_ARTIFACTS_KEY];
+}
+/**
+ * Reads the bundled compiled-artifact snapshot when Nitro has installed one.
+ */
+export function readBundledCompiledArtifacts() {
+    return (globalThis[BUNDLED_COMPILED_ARTIFACTS_KEY] ?? null);
+}
+//# sourceMappingURL=bundled-artifacts.js.map

package/dist/src/runtime/loaders/bundled-artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundled-artifacts.js","sourceRoot":"","sources":["../../../../src/runtime/loaders/bundled-artifacts.ts"],"names":[],"mappings":"AAMA,MAAM,8BAA8B,GAAG,+BAA+B,CAAC;AAwBvE;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAAC,KAA+B;IAC5E,UAAiE,CAChE,8BAA8B,CAC/B,GAAG,KAAK,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B;IAC3C,OAAQ,UAAiE,CACvE,8BAA8B,CAC/B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO,CACJ,UAAiE,CAChE,8BAA8B,CAC/B,IAAI,IAAI,CACV,CAAC;AACJ,CAAC"}

package/dist/src/runtime/loaders/compile-metadata.d.ts

@@ -0,0 +1,22 @@
+import { type CompileMetadata } from "../../compiler/artifacts.js";
+import type { RuntimeCompiledArtifactsSource } from "../compiled-artifacts-source.js";
+/**
+ * Input for loading compile metadata from disk or bundled artifacts.
+ */
+export interface LoadCompileMetadataInput {
+    readonly compiledArtifactsSource: RuntimeCompiledArtifactsSource;
+    readonly metadataPath?: string;
+}
+/**
+ * Error raised when compile metadata cannot be loaded or validated.
+ */
+export declare class LoadCompileMetadataError extends Error {
+    readonly metadataPath?: string;
+    constructor(message: string, metadataPath?: string);
+}
+/**
+ * Loads and validates compile metadata when it is available for the current
+ * artifact source.
+ */
+export declare function loadCompileMetadata(input: LoadCompileMetadataInput): Promise<CompileMetadata | null>;
+//# sourceMappingURL=compile-metadata.d.ts.map

package/dist/src/runtime/loaders/compile-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-metadata.d.ts","sourceRoot":"","sources":["../../../../src/runtime/loaders/compile-metadata.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AA+CtF;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,uBAAuB,EAAE,8BAA8B,CAAC;IACjE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAEnB,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;CAQnD;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAyBjC"}

package/dist/src/runtime/loaders/compile-metadata.js

@@ -0,0 +1,94 @@
+import { readFile } from "node:fs/promises";
+import { z } from "zod";
+import { COMPILE_METADATA_KIND, COMPILE_METADATA_VERSION, resolveCompilerArtifactPaths, } from "../../compiler/artifacts.js";
+import { formatValidationError } from "../validation.js";
+import { readBundledCompiledArtifacts } from "./bundled-artifacts.js";
+const compileArtifactDigestSchema = z
+    .object({
+    path: z.string(),
+    sha256: z.string(),
+})
+    .strict();
+const compileMetadataSchema = z
+    .object({
+    compile: z
+        .object({
+        contextResources: compileArtifactDigestSchema,
+        moduleMap: compileArtifactDigestSchema,
+        workspaceResources: compileArtifactDigestSchema,
+    })
+        .strict(),
+    discovery: z
+        .object({
+        diagnostics: compileArtifactDigestSchema,
+        manifest: compileArtifactDigestSchema,
+        sourceGraphHash: z.string(),
+        summary: z
+            .object({
+            errors: z.number().finite(),
+            warnings: z.number().finite(),
+        })
+            .strict(),
+    })
+        .strict(),
+    generator: z
+        .object({
+        name: z.string(),
+        version: z.string(),
+    })
+        .strict(),
+    kind: z.literal(COMPILE_METADATA_KIND),
+    status: z.union([z.literal("failed"), z.literal("ready")]),
+    version: z.literal(COMPILE_METADATA_VERSION),
+})
+    .strict();
+const BUNDLED_COMPILE_METADATA_SOURCE = "bundled compile metadata";
+/**
+ * Error raised when compile metadata cannot be loaded or validated.
+ */
+export class LoadCompileMetadataError extends Error {
+    metadataPath;
+    constructor(message, metadataPath) {
+        super(message);
+        this.name = "LoadCompileMetadataError";
+        if (metadataPath !== undefined) {
+            this.metadataPath = metadataPath;
+        }
+    }
+}
+/**
+ * Loads and validates compile metadata when it is available for the current
+ * artifact source.
+ */
+export async function loadCompileMetadata(input) {
+    const metadataPath = input.metadataPath ??
+        (input.compiledArtifactsSource.kind === "disk"
+            ? resolveCompilerArtifactPaths(input.compiledArtifactsSource.appRoot).compileMetadataPath
+            : undefined);
+    if (metadataPath !== undefined) {
+        let metadataJson;
+        try {
+            metadataJson = JSON.parse(await readFile(metadataPath, "utf8"));
+        }
+        catch (error) {
+            throw new LoadCompileMetadataError(formatLoadErrorMessage(error), metadataPath);
+        }
+        return parseCompileMetadata(metadataJson, metadataPath);
+    }
+    const bundledArtifacts = readBundledCompiledArtifacts();
+    const bundledMetadata = bundledArtifacts?.metadata;
+    return bundledMetadata === undefined
+        ? null
+        : parseCompileMetadata(bundledMetadata, BUNDLED_COMPILE_METADATA_SOURCE);
+}
+function parseCompileMetadata(value, metadataPath) {
+    const parsed = compileMetadataSchema.safeParse(value);
+    if (!parsed.success) {
+        throw new LoadCompileMetadataError(`Expected "${metadataPath}" to contain valid Ash compile metadata. ${formatValidationError(parsed.error)}`, metadataPath);
+    }
+    return parsed.data;
+}
+function formatLoadErrorMessage(error) {
+    return error instanceof Error ? error.message : "Unknown compile metadata load failure.";
+}
+//# sourceMappingURL=compile-metadata.js.map

package/dist/src/runtime/loaders/compile-metadata.js.map

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

package/dist/src/runtime/loaders/context.d.ts

@@ -0,0 +1,36 @@
+import type { ContextResourcesArtifact } from "../../compiler/context.js";
+import { type RuntimeCompiledArtifactsSource } from "../compiled-artifacts-source.js";
+import type { ResolvedContextDocument } from "../types.js";
+/**
+ * Input for loading compiled context resource metadata from disk or bundled
+ * runtime aliases.
+ */
+export interface LoadCompiledContextResourcesInput {
+    readonly compiledArtifactsSource: RuntimeCompiledArtifactsSource;
+    contextResourcesPath?: string;
+}
+/**
+ * Input for resolving compiled context resources into runtime-owned context
+ * documents.
+ */
+export interface LoadResolvedCompiledContextInput {
+    readonly compiledArtifactsSource: RuntimeCompiledArtifactsSource;
+    contextResources?: ContextResourcesArtifact;
+}
+/**
+ * Error raised when compiled context artifacts cannot be loaded or validated.
+ */
+export declare class LoadCompiledContextResourcesError extends Error {
+    readonly contextResourcesPath?: string;
+    constructor(message: string, contextResourcesPath?: string);
+}
+/**
+ * Loads and validates the compiled context resources artifact.
+ */
+export declare function loadCompiledContextResources(input: LoadCompiledContextResourcesInput): Promise<ContextResourcesArtifact>;
+/**
+ * Resolves compiled context resources into the runtime-owned context document
+ * model.
+ */
+export declare function loadResolvedCompiledContext(input: LoadResolvedCompiledContextInput): Promise<ResolvedContextDocument[]>;
+//# sourceMappingURL=context.d.ts.map

package/dist/src/runtime/loaders/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../src/runtime/loaders/context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAGV,wBAAwB,EACzB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAO3D;;;GAGG;AACH,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,uBAAuB,EAAE,8BAA8B,CAAC;IACjE,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,uBAAuB,EAAE,8BAA8B,CAAC;IACjE,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;CAC7C;AAED;;GAEG;AACH,qBAAa,iCAAkC,SAAQ,KAAK;IAC1D,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;gBAE3B,OAAO,EAAE,MAAM,EAAE,oBAAoB,CAAC,EAAE,MAAM;CAQ3D;AAED;;GAEG;AACH,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,iCAAiC,GACvC,OAAO,CAAC,wBAAwB,CAAC,CAmCnC;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,gCAAgC,GACtC,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAmBpC"}

package/dist/src/runtime/loaders/context.js

@@ -0,0 +1,116 @@
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { resolveCompilerArtifactPaths } from "../../compiler/artifacts.js";
+import { contextResourcesArtifactSchema } from "../../compiler/context.js";
+import { getRuntimeCompiledArtifactsAppRoot, } from "../compiled-artifacts-source.js";
+import { formatValidationError } from "../validation.js";
+import { readBundledCompiledArtifacts } from "./bundled-artifacts.js";
+const BUNDLED_CONTEXT_FILES_SOURCE = "bundled compiled context files";
+const BUNDLED_CONTEXT_RESOURCES_SOURCE = "bundled compiled context resources";
+/**
+ * Error raised when compiled context artifacts cannot be loaded or validated.
+ */
+export class LoadCompiledContextResourcesError extends Error {
+    contextResourcesPath;
+    constructor(message, contextResourcesPath) {
+        super(message);
+        this.name = "LoadCompiledContextResourcesError";
+        if (contextResourcesPath !== undefined) {
+            this.contextResourcesPath = contextResourcesPath;
+        }
+    }
+}
+/**
+ * Loads and validates the compiled context resources artifact.
+ */
+export async function loadCompiledContextResources(input) {
+    const contextResourcesPath = input.contextResourcesPath ??
+        (input.compiledArtifactsSource.kind === "disk"
+            ? resolveCompilerArtifactPaths(input.compiledArtifactsSource.appRoot).contextResourcesPath
+            : undefined);
+    if (contextResourcesPath !== undefined) {
+        let contextResourcesJson;
+        try {
+            contextResourcesJson = JSON.parse(await readFile(contextResourcesPath, "utf8"));
+        }
+        catch (error) {
+            throw new LoadCompiledContextResourcesError(formatLoadErrorMessage(error), contextResourcesPath);
+        }
+        return parseCompiledContextResources(contextResourcesJson, contextResourcesPath);
+    }
+    const bundledArtifacts = readBundledCompiledArtifacts();
+    if (bundledArtifacts !== null) {
+        return parseCompiledContextResources(bundledArtifacts.contextResources, BUNDLED_CONTEXT_RESOURCES_SOURCE);
+    }
+    throw new LoadCompiledContextResourcesError("Compiled context resources are unavailable without an app root or bundled compiled artifacts.", BUNDLED_CONTEXT_RESOURCES_SOURCE);
+}
+/**
+ * Resolves compiled context resources into the runtime-owned context document
+ * model.
+ */
+export async function loadResolvedCompiledContext(input) {
+    const appRoot = getRuntimeCompiledArtifactsAppRoot(input.compiledArtifactsSource);
+    const contextResources = input.contextResources ??
+        (await loadCompiledContextResources({
+            compiledArtifactsSource: input.compiledArtifactsSource,
+        }));
+    const documents = await Promise.all(contextResources.resources.map(async (resource) => {
+        if (resource.definitionKind === "file") {
+            return await resolveCompiledContextFile(resource, appRoot);
+        }
+        return resolveCompiledContextModule(resource);
+    }));
+    return documents.sort((left, right) => left.logicalPath.localeCompare(right.logicalPath));
+}
+function parseCompiledContextResources(value, contextResourcesPath) {
+    const parsed = contextResourcesArtifactSchema.safeParse(value);
+    if (!parsed.success) {
+        throw new LoadCompiledContextResourcesError(`Expected "${contextResourcesPath}" to contain a valid compiled Ash context artifact. ${formatValidationError(parsed.error)}`, contextResourcesPath);
+    }
+    return parsed.data;
+}
+async function resolveCompiledContextFile(resource, appRoot) {
+    return {
+        content: await loadCompiledContextFileContent(resource, appRoot),
+        logicalPath: resource.logicalPath,
+        mediaType: resource.mediaType,
+        sourceId: resource.sourceId,
+        sourceKind: "file",
+    };
+}
+function resolveCompiledContextModule(resource) {
+    const document = {
+        content: resource.content,
+        logicalPath: resource.logicalPath,
+        sourceId: resource.sourceId,
+        sourceKind: "module",
+    };
+    if (resource.id !== undefined) {
+        document.id = resource.id;
+    }
+    if (resource.mediaType !== undefined) {
+        document.mediaType = resource.mediaType;
+    }
+    if (resource.title !== undefined) {
+        document.title = resource.title;
+    }
+    return document;
+}
+async function loadCompiledContextFileContent(resource, appRoot) {
+    if (appRoot !== undefined) {
+        return await readFile(resolve(appRoot, resource.compiledPath), "utf8");
+    }
+    const bundledArtifacts = readBundledCompiledArtifacts();
+    const bundledContent = bundledArtifacts?.contextFiles[resource.sourceId];
+    if (typeof bundledContent === "string") {
+        return bundledContent;
+    }
+    throw new LoadCompiledContextResourcesError(`Missing bundled compiled context content for "${resource.sourceId}".`, BUNDLED_CONTEXT_FILES_SOURCE);
+}
+function formatLoadErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return "Unknown context artifact load failure.";
+}
+//# sourceMappingURL=context.js.map

package/dist/src/runtime/loaders/context.js.map

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

package/dist/src/runtime/loaders/manifest.d.ts

@@ -0,0 +1,22 @@
+import { type CompiledAgentManifest } from "../../compiler/manifest.js";
+import type { RuntimeCompiledArtifactsSource } from "../compiled-artifacts-source.js";
+/**
+ * Input for loading the compiled source manifest from disk or the bundled
+ * runtime alias.
+ */
+export interface LoadCompiledManifestInput {
+    readonly compiledArtifactsSource: RuntimeCompiledArtifactsSource;
+    manifestPath?: string;
+}
+/**
+ * Error raised when the compiled manifest cannot be loaded or validated.
+ */
+export declare class LoadCompiledManifestError extends Error {
+    readonly manifestPath?: string;
+    constructor(message: string, manifestPath?: string);
+}
+/**
+ * Loads and validates the compiler-owned source manifest.
+ */
+export declare function loadCompiledManifest(input: LoadCompiledManifestInput): Promise<CompiledAgentManifest>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/src/runtime/loaders/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../../src/runtime/loaders/manifest.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,qBAAqB,EAE3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AAMtF;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,uBAAuB,EAAE,8BAA8B,CAAC;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAEnB,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;CAQnD;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,qBAAqB,CAAC,CA6BhC"}

package/dist/src/runtime/loaders/manifest.js

@@ -0,0 +1,57 @@
+import { readFile } from "node:fs/promises";
+import { resolveCompilerArtifactPaths } from "../../compiler/artifacts.js";
+import { compiledAgentManifestSchema, } from "../../compiler/manifest.js";
+import { formatValidationError } from "../validation.js";
+import { readBundledCompiledArtifacts } from "./bundled-artifacts.js";
+const BUNDLED_MANIFEST_SOURCE = "bundled compiled manifest";
+/**
+ * Error raised when the compiled manifest cannot be loaded or validated.
+ */
+export class LoadCompiledManifestError extends Error {
+    manifestPath;
+    constructor(message, manifestPath) {
+        super(message);
+        this.name = "LoadCompiledManifestError";
+        if (manifestPath !== undefined) {
+            this.manifestPath = manifestPath;
+        }
+    }
+}
+/**
+ * Loads and validates the compiler-owned source manifest.
+ */
+export async function loadCompiledManifest(input) {
+    const manifestPath = input.manifestPath ??
+        (input.compiledArtifactsSource.kind === "disk"
+            ? resolveCompilerArtifactPaths(input.compiledArtifactsSource.appRoot).compiledManifestPath
+            : undefined);
+    if (manifestPath !== undefined) {
+        let manifestJson;
+        try {
+            manifestJson = JSON.parse(await readFile(manifestPath, "utf8"));
+        }
+        catch (error) {
+            throw new LoadCompiledManifestError(formatLoadErrorMessage(error), manifestPath);
+        }
+        return parseCompiledManifest(manifestJson, manifestPath);
+    }
+    const bundledArtifacts = readBundledCompiledArtifacts();
+    if (bundledArtifacts !== null) {
+        return parseCompiledManifest(bundledArtifacts.manifest, BUNDLED_MANIFEST_SOURCE);
+    }
+    throw new LoadCompiledManifestError("Compiled manifest is unavailable without an app root or bundled compiled artifacts.", BUNDLED_MANIFEST_SOURCE);
+}
+function parseCompiledManifest(value, manifestPath) {
+    const parsed = compiledAgentManifestSchema.safeParse(value);
+    if (!parsed.success) {
+        throw new LoadCompiledManifestError(`Expected "${manifestPath}" to contain a valid compiled Ash agent manifest. ${formatValidationError(parsed.error)}`, manifestPath);
+    }
+    return parsed.data;
+}
+function formatLoadErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return "Unknown manifest load failure.";
+}
+//# sourceMappingURL=manifest.js.map

package/dist/src/runtime/loaders/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../../src/runtime/loaders/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAEL,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAEtE,MAAM,uBAAuB,GAAG,2BAA2B,CAAC;AAW5D;;GAEG;AACH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IACzC,YAAY,CAAU;IAE/B,YAAY,OAAe,EAAE,YAAqB;QAChD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QAExC,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACnC,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAgC;IAEhC,MAAM,YAAY,GAChB,KAAK,CAAC,YAAY;QAClB,CAAC,KAAK,CAAC,uBAAuB,CAAC,IAAI,KAAK,MAAM;YAC5C,CAAC,CAAC,4BAA4B,CAAC,KAAK,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,oBAAoB;YAC1F,CAAC,CAAC,SAAS,CAAC,CAAC;IAEjB,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,YAAqB,CAAC;QAE1B,IAAI,CAAC;YACH,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;QAClE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,yBAAyB,CAAC,sBAAsB,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC;QACnF,CAAC;QAED,OAAO,qBAAqB,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,gBAAgB,GAAG,4BAA4B,EAAE,CAAC;IAExD,IAAI,gBAAgB,KAAK,IAAI,EAAE,CAAC;QAC9B,OAAO,qBAAqB,CAAC,gBAAgB,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAAC;IACnF,CAAC;IAED,MAAM,IAAI,yBAAyB,CACjC,qFAAqF,EACrF,uBAAuB,CACxB,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc,EAAE,YAAoB;IACjE,MAAM,MAAM,GAAG,2BAA2B,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAE5D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,yBAAyB,CACjC,aAAa,YAAY,qDAAqD,qBAAqB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EACnH,YAAY,CACb,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,OAAO,gCAAgC,CAAC;AAC1C,CAAC"}

package/dist/src/runtime/loaders/module-map.d.ts

@@ -0,0 +1,22 @@
+import { type CompiledModuleMap } from "../../compiler/module-map.js";
+import type { RuntimeCompiledArtifactsSource } from "../compiled-artifacts-source.js";
+/**
+ * Input for loading the compiled module map from disk or the bundled runtime
+ * alias.
+ */
+export interface LoadCompiledModuleMapInput {
+    readonly compiledArtifactsSource: RuntimeCompiledArtifactsSource;
+    moduleMapPath?: string;
+}
+/**
+ * Error raised when the compiled module map cannot be loaded or validated.
+ */
+export declare class LoadCompiledModuleMapError extends Error {
+    readonly moduleMapPath?: string;
+    constructor(message: string, moduleMapPath?: string);
+}
+/**
+ * Loads and validates the compiler-owned module map.
+ */
+export declare function loadCompiledModuleMap(input: LoadCompiledModuleMapInput): Promise<CompiledModuleMap>;
+//# sourceMappingURL=module-map.d.ts.map

package/dist/src/runtime/loaders/module-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-map.d.ts","sourceRoot":"","sources":["../../../../src/runtime/loaders/module-map.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,iBAAiB,EAA2B,MAAM,8BAA8B,CAAC;AAC/F,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AAMtF;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,uBAAuB,EAAE,8BAA8B,CAAC;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;gBAEpB,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM;CAQpD;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,iBAAiB,CAAC,CAiC5B"}

package/dist/src/runtime/loaders/module-map.js

@@ -0,0 +1,56 @@
+import { pathToFileURL } from "node:url";
+import { resolveCompilerArtifactPaths } from "../../compiler/artifacts.js";
+import { compiledModuleMapSchema } from "../../compiler/module-map.js";
+import { formatValidationError } from "../validation.js";
+import { readBundledCompiledArtifacts } from "./bundled-artifacts.js";
+const BUNDLED_MODULE_MAP_SOURCE = "bundled compiled module map";
+/**
+ * Error raised when the compiled module map cannot be loaded or validated.
+ */
+export class LoadCompiledModuleMapError extends Error {
+    moduleMapPath;
+    constructor(message, moduleMapPath) {
+        super(message);
+        this.name = "LoadCompiledModuleMapError";
+        if (moduleMapPath !== undefined) {
+            this.moduleMapPath = moduleMapPath;
+        }
+    }
+}
+/**
+ * Loads and validates the compiler-owned module map.
+ */
+export async function loadCompiledModuleMap(input) {
+    const moduleMapPath = input.moduleMapPath ??
+        (input.compiledArtifactsSource.kind === "disk"
+            ? resolveCompilerArtifactPaths(input.compiledArtifactsSource.appRoot).moduleMapPath
+            : undefined);
+    if (moduleMapPath !== undefined) {
+        try {
+            const moduleNamespace = (await import(pathToFileURL(moduleMapPath).href));
+            return parseCompiledModuleMap(moduleNamespace.moduleMap ?? moduleNamespace.default, moduleMapPath);
+        }
+        catch (error) {
+            throw new LoadCompiledModuleMapError(formatLoadErrorMessage(error), moduleMapPath);
+        }
+    }
+    const bundledArtifacts = readBundledCompiledArtifacts();
+    if (bundledArtifacts !== null) {
+        return parseCompiledModuleMap(bundledArtifacts.moduleMap, BUNDLED_MODULE_MAP_SOURCE);
+    }
+    throw new LoadCompiledModuleMapError("Compiled module map is unavailable without an app root or bundled compiled artifacts.", BUNDLED_MODULE_MAP_SOURCE);
+}
+function parseCompiledModuleMap(value, moduleMapPath) {
+    const parsed = compiledModuleMapSchema.safeParse(value);
+    if (!parsed.success) {
+        throw new LoadCompiledModuleMapError(`Expected "${moduleMapPath}" to export a valid compiled Ash module map. ${formatValidationError(parsed.error)}`, moduleMapPath);
+    }
+    return parsed.data;
+}
+function formatLoadErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return "Unknown module-map load failure.";
+}
+//# sourceMappingURL=module-map.js.map

package/dist/src/runtime/loaders/module-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-map.js","sourceRoot":"","sources":["../../../../src/runtime/loaders/module-map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAA0B,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAE/F,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAEtE,MAAM,yBAAyB,GAAG,6BAA6B,CAAC;AAWhE;;GAEG;AACH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAC1C,aAAa,CAAU;IAEhC,YAAY,OAAe,EAAE,aAAsB;QACjD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QAEzC,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACrC,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAiC;IAEjC,MAAM,aAAa,GACjB,KAAK,CAAC,aAAa;QACnB,CAAC,KAAK,CAAC,uBAAuB,CAAC,IAAI,KAAK,MAAM;YAC5C,CAAC,CAAC,4BAA4B,CAAC,KAAK,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,aAAa;YACnF,CAAC,CAAC,SAAS,CAAC,CAAC;IAEjB,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,eAAe,GAAG,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAGvE,CAAC;YAEF,OAAO,sBAAsB,CAC3B,eAAe,CAAC,SAAS,IAAI,eAAe,CAAC,OAAO,EACpD,aAAa,CACd,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,0BAA0B,CAAC,sBAAsB,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IAED,MAAM,gBAAgB,GAAG,4BAA4B,EAAE,CAAC;IAExD,IAAI,gBAAgB,KAAK,IAAI,EAAE,CAAC;QAC9B,OAAO,sBAAsB,CAAC,gBAAgB,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,IAAI,0BAA0B,CAClC,uFAAuF,EACvF,yBAAyB,CAC1B,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAc,EAAE,aAAqB;IACnE,MAAM,MAAM,GAAG,uBAAuB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAExD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,0BAA0B,CAClC,aAAa,aAAa,gDAAgD,qBAAqB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC/G,aAAa,CACd,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,OAAO,kCAAkC,CAAC;AAC5C,CAAC"}

package/dist/src/runtime/loaders/resolved-agent.d.ts

@@ -0,0 +1,28 @@
+import type { RuntimeCompiledArtifactsSource } from "../compiled-artifacts-source.js";
+import type { ResolvedAgentGraphBundle } from "../graph.js";
+import type { ResolvedAgent } from "../types.js";
+/**
+ * Input for loading and resolving the compiled authored agent from framework
+ * artifacts.
+ */
+export interface LoadResolvedCompiledAgentInput {
+    readonly compiledArtifactsSource: RuntimeCompiledArtifactsSource;
+}
+/**
+ * Input for loading the recursive resolved runtime-owned agent graph from
+ * compiled artifacts.
+ */
+export interface LoadResolvedCompiledAgentGraphInput {
+    readonly compiledArtifactsSource: RuntimeCompiledArtifactsSource;
+}
+/**
+ * Loads the compiled manifest and recursive module map, then resolves them
+ * into the runtime-owned recursive agent graph bundle.
+ */
+export declare function loadResolvedCompiledAgentGraph(input: LoadResolvedCompiledAgentGraphInput): Promise<ResolvedAgentGraphBundle>;
+/**
+ * Loads the compiled manifest and module map, then resolves the root agent from
+ * the recursive runtime-owned graph bundle.
+ */
+export declare function loadResolvedCompiledAgent(input: LoadResolvedCompiledAgentInput): Promise<ResolvedAgent>;
+//# sourceMappingURL=resolved-agent.d.ts.map

package/dist/src/runtime/loaders/resolved-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolved-agent.d.ts","sourceRoot":"","sources":["../../../../src/runtime/loaders/resolved-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjD;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,uBAAuB,EAAE,8BAA8B,CAAC;CAClE;AAED;;;GAGG;AACH,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,uBAAuB,EAAE,8BAA8B,CAAC;CAClE;AAED;;;GAGG;AACH,wBAAsB,8BAA8B,CAClD,KAAK,EAAE,mCAAmC,GACzC,OAAO,CAAC,wBAAwB,CAAC,CAoBnC;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,aAAa,CAAC,CAMxB"}

package/dist/src/runtime/loaders/resolved-agent.js

@@ -0,0 +1,39 @@
+import { resolveRuntimeAgentGraph } from "../resolve-agent-graph.js";
+import { loadResolvedCompiledContext } from "./context.js";
+import { loadCompiledManifest } from "./manifest.js";
+import { loadCompiledModuleMap } from "./module-map.js";
+import { loadResolvedCompiledWorkspace } from "./workspace.js";
+/**
+ * Loads the compiled manifest and recursive module map, then resolves them
+ * into the runtime-owned recursive agent graph bundle.
+ */
+export async function loadResolvedCompiledAgentGraph(input) {
+    const [manifest, moduleMap] = await Promise.all([
+        loadCompiledManifest({
+            compiledArtifactsSource: input.compiledArtifactsSource,
+        }),
+        loadCompiledModuleMap({
+            compiledArtifactsSource: input.compiledArtifactsSource,
+        }),
+    ]);
+    return await resolveRuntimeAgentGraph({
+        contextDocuments: await loadResolvedCompiledContext({
+            compiledArtifactsSource: input.compiledArtifactsSource,
+        }),
+        manifest,
+        moduleMap,
+        workspaceFiles: await loadResolvedCompiledWorkspace({
+            compiledArtifactsSource: input.compiledArtifactsSource,
+        }),
+    });
+}
+/**
+ * Loads the compiled manifest and module map, then resolves the root agent from
+ * the recursive runtime-owned graph bundle.
+ */
+export async function loadResolvedCompiledAgent(input) {
+    return (await loadResolvedCompiledAgentGraph({
+        compiledArtifactsSource: input.compiledArtifactsSource,
+    })).root.agent;
+}
+//# sourceMappingURL=resolved-agent.js.map

package/dist/src/runtime/loaders/resolved-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolved-agent.js","sourceRoot":"","sources":["../../../../src/runtime/loaders/resolved-agent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAErE,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAkB/D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,KAA0C;IAE1C,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC9C,oBAAoB,CAAC;YACnB,uBAAuB,EAAE,KAAK,CAAC,uBAAuB;SACvD,CAAC;QACF,qBAAqB,CAAC;YACpB,uBAAuB,EAAE,KAAK,CAAC,uBAAuB;SACvD,CAAC;KACH,CAAC,CAAC;IAEH,OAAO,MAAM,wBAAwB,CAAC;QACpC,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;YAClD,uBAAuB,EAAE,KAAK,CAAC,uBAAuB;SACvD,CAAC;QACF,QAAQ;QACR,SAAS;QACT,cAAc,EAAE,MAAM,6BAA6B,CAAC;YAClD,uBAAuB,EAAE,KAAK,CAAC,uBAAuB;SACvD,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,KAAqC;IAErC,OAAO,CACL,MAAM,8BAA8B,CAAC;QACnC,uBAAuB,EAAE,KAAK,CAAC,uBAAuB;KACvD,CAAC,CACH,CAAC,IAAI,CAAC,KAAK,CAAC;AACf,CAAC"}