experimental-ash 0.1.0-alpha.1

package/dist/src/compiler/normalize-manifest.d.ts

@@ -0,0 +1,20 @@
+import type { AgentSourceManifest } from "../discover/manifest.js";
+import type { ModuleSourceRef } from "../internal/source-ref.js";
+import { type CompiledAgentManifest } from "./manifest.js";
+/**
+ * Compiles one discovery manifest into the normalized manifest loaded by the runtime.
+ */
+export declare function compileAgentManifest(manifest: AgentSourceManifest): Promise<CompiledAgentManifest>;
+/**
+ * Normalizes one module-backed context definition for the compiled context artifact.
+ */
+export declare function compileContextDocumentDefinition(input: {
+    readonly agentRoot: string;
+    readonly source: ModuleSourceRef;
+}): Promise<{
+    readonly content: string;
+    readonly id?: string;
+    readonly mediaType?: string;
+    readonly title?: string;
+}>;
+//# sourceMappingURL=normalize-manifest.d.ts.map

package/dist/src/compiler/normalize-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-manifest.d.ts","sourceRoot":"","sources":["../../../src/compiler/normalize-manifest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EAKpB,MAAM,yBAAyB,CAAC;AAoBjC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAEL,KAAK,qBAAqB,EAc3B,MAAM,eAAe,CAAC;AAEvB;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,mBAAmB,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CAehC;AAED;;GAEG;AACH,wBAAsB,gCAAgC,CAAC,KAAK,EAAE;IAC5D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;CAClC,GAAG,OAAO,CAAC;IACV,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC,CAgBD"}

package/dist/src/compiler/normalize-manifest.js

@@ -0,0 +1,315 @@
+import { join } from "node:path";
+import { stripLogicalPathExtension } from "../discover/filesystem.js";
+import { normalizeAgentDefinition, normalizeContextDocumentDefinition, normalizeScheduleDefinition, normalizeSkillDefinition, normalizeSystemDefinition, } from "../internal/authored-definition/core.js";
+import { normalizeSandboxDefinition } from "../internal/authored-definition/sandbox.js";
+import { normalizeSubagentDefinition, normalizeToolDefinition, } from "../internal/authored-definition/schema-backed.js";
+import { expectObjectRecord, getAuthoredModuleExport, loadAuthoredModuleNamespace, materializeAuthoredModuleExport, } from "../internal/authored-module.js";
+import { DEFAULT_RUNTIME_MODEL_ID } from "../internal/runtime-model.js";
+import { createCompiledAgentManifest, createCompiledAgentNodeManifest, createCompiledSubagentNodeId, ROOT_COMPILED_AGENT_NODE_ID, } from "./manifest.js";
+/**
+ * Compiles one discovery manifest into the normalized manifest loaded by the runtime.
+ */
+export async function compileAgentManifest(manifest) {
+    const [compiledNode, subagentGraph] = await Promise.all([
+        compileAgentNodeManifest(manifest),
+        compileSubagentGraph({
+            appRoot: manifest.appRoot,
+            parentNodeId: ROOT_COMPILED_AGENT_NODE_ID,
+            subagents: manifest.subagents,
+        }),
+    ]);
+    return createCompiledAgentManifest({
+        ...compiledNode,
+        subagentEdges: subagentGraph.edges,
+        subagents: subagentGraph.nodes,
+    });
+}
+/**
+ * Normalizes one module-backed context definition for the compiled context artifact.
+ */
+export async function compileContextDocumentDefinition(input) {
+    const definition = normalizeContextDocumentDefinition(await loadModuleBackedDefinition({
+        agentRoot: input.agentRoot,
+        kind: "context",
+        source: input.source,
+    }), `Expected the context export "${input.source.exportName ?? "default"}" from "${input.source.logicalPath}" to match the public Ash shape.`);
+    return {
+        content: definition.content,
+        id: definition.id,
+        mediaType: definition.mediaType,
+        title: definition.title,
+    };
+}
+async function compileAgentNodeManifest(manifest) {
+    return createCompiledAgentNodeManifest({
+        agentId: manifest.agentId,
+        agentRoot: manifest.agentRoot,
+        appRoot: manifest.appRoot,
+        config: await compileAgentConfig(manifest),
+        context: manifest.context,
+        diagnosticsSummary: manifest.diagnosticsSummary,
+        promptLayers: manifest.system === undefined
+            ? []
+            : [await compilePromptLayer(manifest.agentRoot, manifest.system)],
+        sandboxes: await Promise.all(manifest.sandboxes.map((sandboxSource) => compileSandboxDefinition(manifest.agentRoot, sandboxSource))),
+        schedules: await Promise.all(manifest.schedules.map((scheduleSource) => compileScheduleDefinition(manifest.agentRoot, scheduleSource))),
+        skills: await Promise.all(manifest.skills.map((skillSource) => compileSkillSource(manifest.agentRoot, skillSource))),
+        tools: await Promise.all(manifest.tools.map((toolSource) => compileToolDefinition(manifest.agentRoot, toolSource))),
+        workspace: manifest.workspace,
+    });
+}
+async function compileAgentConfig(manifest) {
+    if (manifest.configModule === undefined) {
+        return {
+            metadata: {},
+            model: {
+                id: DEFAULT_RUNTIME_MODEL_ID,
+            },
+        };
+    }
+    const definition = normalizeAgentDefinition(await loadModuleBackedDefinition({
+        agentRoot: manifest.agentRoot,
+        kind: "agent config",
+        source: manifest.configModule,
+    }), `Expected the agent config export "${manifest.configModule.exportName ?? "default"}" from "${manifest.configModule.logicalPath}" to match the public Ash shape.`);
+    const model = normalizeAuthoredModelReference(definition.model, manifest.configModule);
+    const compiledConfig = {
+        metadata: definition.metadata ?? {},
+        model,
+    };
+    if (definition.id !== undefined) {
+        compiledConfig.id = definition.id;
+    }
+    if (manifest.configModule !== undefined) {
+        compiledConfig.source = {
+            exportName: manifest.configModule.exportName,
+            kind: "module",
+            logicalPath: manifest.configModule.logicalPath,
+            sourceId: manifest.configModule.sourceId,
+        };
+    }
+    return compiledConfig;
+}
+async function compilePromptLayer(agentRoot, source) {
+    if (source === undefined) {
+        throw new Error("Missing system source while compiling prompt layers.");
+    }
+    const definition = source.kind === "markdown"
+        ? normalizeSystemDefinition(source.definition, `Expected the compiled system definition at "${source.logicalPath}" to match the public Ash shape.`)
+        : normalizeSystemDefinition(await loadModuleBackedDefinition({
+            agentRoot,
+            kind: "system",
+            source,
+        }), `Expected the system export "${source.exportName ?? "default"}" from "${source.logicalPath}" to match the public Ash shape.`);
+    return {
+        id: definition.id ?? stripLogicalPathExtension(source.logicalPath),
+        kind: "system",
+        logicalPath: source.logicalPath,
+        markdown: definition.markdown,
+        sourceId: source.sourceId,
+        sourceKind: source.kind,
+    };
+}
+async function compileSkillSource(agentRoot, source) {
+    if (source.kind === "skill-package") {
+        return compileSkillPackageSource(source);
+    }
+    const definition = source.kind === "markdown"
+        ? normalizeSkillDefinition(source.definition, `Expected the compiled skill definition at "${source.logicalPath}" to match the public Ash shape.`)
+        : normalizeSkillDefinition(await loadModuleBackedDefinition({
+            agentRoot,
+            kind: "skill",
+            source,
+        }), `Expected the skill export "${source.exportName ?? "default"}" from "${source.logicalPath}" to match the public Ash shape.`);
+    return {
+        compatibility: definition.compatibility,
+        description: definition.description,
+        license: definition.license,
+        logicalPath: source.logicalPath,
+        markdown: definition.markdown,
+        metadata: definition.metadata === undefined
+            ? undefined
+            : {
+                ...definition.metadata,
+            },
+        name: definition.name,
+        sourceId: source.sourceId,
+        sourceKind: source.kind,
+        skillId: definition.id ?? stripLogicalPathExtension(source.logicalPath),
+    };
+}
+function compileSkillPackageSource(source) {
+    return {
+        assetsPath: source.assetsPath,
+        compatibility: source.compatibility,
+        description: source.description,
+        license: source.license,
+        logicalPath: source.logicalPath,
+        markdown: source.markdown,
+        metadata: source.metadata === undefined
+            ? undefined
+            : {
+                ...source.metadata,
+            },
+        name: source.name,
+        referencesPath: source.referencesPath,
+        rootPath: source.rootPath,
+        scriptsPath: source.scriptsPath,
+        skillFilePath: source.skillFilePath,
+        skillId: source.skillId,
+        sourceId: source.sourceId,
+        sourceKind: "skill-package",
+    };
+}
+async function compileScheduleDefinition(agentRoot, source) {
+    const definition = source.kind === "markdown"
+        ? normalizeScheduleDefinition(source.definition, `Expected the compiled schedule definition at "${source.logicalPath}" to match the public Ash shape.`)
+        : normalizeScheduleDefinition(await loadModuleBackedDefinition({
+            agentRoot,
+            kind: "schedule",
+            source,
+        }), `Expected the schedule export "${source.exportName ?? "default"}" from "${source.logicalPath}" to match the public Ash shape.`);
+    return {
+        cron: definition.cron,
+        id: definition.id ?? stripLogicalPathExtension(source.logicalPath),
+        logicalPath: source.logicalPath,
+        markdown: definition.markdown,
+        sourceId: source.sourceId,
+        sourceKind: source.kind,
+    };
+}
+async function compileToolDefinition(agentRoot, source) {
+    const definition = normalizeToolDefinition(await loadModuleBackedDefinition({
+        agentRoot,
+        kind: "tool",
+        source,
+    }), `Expected the tool export "${source.exportName ?? "default"}" from "${source.logicalPath}" to match the public Ash shape.`);
+    return {
+        description: definition.description,
+        exportName: source.exportName,
+        inputSchema: definition.inputSchema ?? null,
+        logicalPath: source.logicalPath,
+        name: definition.name,
+        sourceId: source.sourceId,
+        sourceKind: "module",
+    };
+}
+async function compileSandboxDefinition(agentRoot, source) {
+    const definition = normalizeSandboxDefinition(await loadModuleBackedDefinition({
+        agentRoot,
+        kind: "sandbox",
+        source,
+    }), `Expected the sandbox export "${source.exportName ?? "default"}" from "${source.logicalPath}" to match the public Ash shape.`);
+    const sandboxName = stripLogicalPathExtension(source.logicalPath).replace(/^sandboxes\//, "");
+    return {
+        description: definition.description ?? null,
+        exportName: source.exportName,
+        logicalPath: source.logicalPath,
+        name: sandboxName,
+        sourceId: source.sourceId,
+        sourceKind: "module",
+    };
+}
+async function compileSubagentGraph(input) {
+    const compiledNodes = [];
+    const compiledEdges = [];
+    for (const subagentSource of input.subagents) {
+        const compiledSubagent = await compileLocalSubagent({
+            appRoot: input.appRoot,
+            parentNodeId: input.parentNodeId,
+            source: subagentSource,
+        });
+        compiledNodes.push(compiledSubagent.node, ...compiledSubagent.descendants.nodes);
+        compiledEdges.push({
+            childNodeId: compiledSubagent.node.nodeId,
+            parentNodeId: input.parentNodeId,
+        }, ...compiledSubagent.descendants.edges);
+    }
+    return {
+        edges: compiledEdges,
+        nodes: compiledNodes,
+    };
+}
+async function compileLocalSubagent(input) {
+    if (input.source.manifest.subagentModule === undefined) {
+        throw new Error(`Missing the local subagent definition module for "${input.source.logicalPath}" while compiling authored definitions.`);
+    }
+    const definition = normalizeSubagentDefinition(await loadModuleBackedDefinition({
+        agentRoot: input.source.rootPath,
+        kind: "local subagent",
+        source: input.source.manifest.subagentModule,
+    }), `Expected the local subagent export "${input.source.manifest.subagentModule.exportName ?? "default"}" from "${input.source.manifest.subagentModule.logicalPath}" to match the public Ash shape.`);
+    const subagentId = definition.id ?? input.source.subagentId;
+    const nodeId = createCompiledSubagentNodeId(input.parentNodeId, input.source.sourceId);
+    const agent = await compileAgentNodeManifest({
+        ...input.source.manifest,
+        agentId: subagentId,
+        appRoot: input.appRoot,
+    });
+    const descendants = await compileSubagentGraph({
+        appRoot: input.appRoot,
+        parentNodeId: nodeId,
+        subagents: input.source.manifest.subagents,
+    });
+    return {
+        descendants,
+        node: {
+            agent,
+            description: definition.description,
+            entryPath: input.source.entryPath,
+            inputSchema: definition.inputSchema,
+            logicalPath: input.source.logicalPath,
+            name: definition.name,
+            nodeId,
+            rootPath: input.source.rootPath,
+            sourceId: input.source.sourceId,
+            subagentId,
+        },
+    };
+}
+async function loadModuleBackedDefinition(input) {
+    const moduleNamespace = await loadAuthoredModuleNamespace(join(input.agentRoot, input.source.logicalPath));
+    const exportValue = getAuthoredModuleExport(moduleNamespace, input.source);
+    try {
+        return await materializeAuthoredModuleExport(exportValue);
+    }
+    catch (error) {
+        throw new Error(`Failed to execute the ${input.kind} export "${input.source.exportName ?? "default"}" from "${input.source.logicalPath}": ${formatUnknownError(error)}`);
+    }
+}
+function normalizeAuthoredModelReference(value, source) {
+    if (value === undefined) {
+        return {
+            id: DEFAULT_RUNTIME_MODEL_ID,
+        };
+    }
+    if (typeof value === "string") {
+        return {
+            id: value,
+        };
+    }
+    const record = expectObjectRecord(value, `Expected the authored agent config export "${source.exportName ?? "default"}" from "${source.logicalPath}" to provide a valid AI SDK language model.`);
+    const specificationVersion = record.specificationVersion;
+    if (specificationVersion !== "v2" && specificationVersion !== "v3") {
+        throw new Error(`Expected the authored agent config export "${source.exportName ?? "default"}" from "${source.logicalPath}" to provide a valid AI SDK language model.`);
+    }
+    if (typeof record.provider !== "string" ||
+        typeof record.modelId !== "string" ||
+        typeof record.doGenerate !== "function" ||
+        typeof record.doStream !== "function") {
+        throw new Error(`Expected the authored agent config export "${source.exportName ?? "default"}" from "${source.logicalPath}" to provide a valid AI SDK language model.`);
+    }
+    return {
+        id: `${record.provider}/${record.modelId}`,
+        source: {
+            exportName: source.exportName,
+            kind: "module",
+            logicalPath: source.logicalPath,
+            sourceId: source.sourceId,
+        },
+    };
+}
+function formatUnknownError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=normalize-manifest.js.map

package/dist/src/compiler/normalize-manifest.js.map

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

package/dist/src/compiler/resource-files.d.ts

@@ -0,0 +1,20 @@
+/**
+ * One copied compiled resource file staged under `.ash/compile/`.
+ */
+export interface CopiedCompiledResourceFile {
+    compiledPath: string;
+    content: Uint8Array;
+    contentSha256: string;
+}
+/**
+ * Copies one authored file into a compiled artifact directory and returns the
+ * staged path metadata shared by context and workspace artifacts.
+ */
+export declare function copyCompiledResourceFile(input: {
+    agentRoot: string;
+    appRoot: string;
+    compileDirectoryPath: string;
+    copiedLogicalPath: string;
+    logicalPath: string;
+}): Promise<CopiedCompiledResourceFile>;
+//# sourceMappingURL=resource-files.d.ts.map

package/dist/src/compiler/resource-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-files.d.ts","sourceRoot":"","sources":["../../../src/compiler/resource-files.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,UAAU,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,KAAK,EAAE;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAetC"}

package/dist/src/compiler/resource-files.js

@@ -0,0 +1,29 @@
+import { createHash } from "node:crypto";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join, relative, resolve } from "node:path";
+import { normalizeLogicalPath } from "../discover/filesystem.js";
+/**
+ * Copies one authored file into a compiled artifact directory and returns the
+ * staged path metadata shared by context and workspace artifacts.
+ */
+export async function copyCompiledResourceFile(input) {
+    const sourcePath = join(input.agentRoot, input.logicalPath);
+    const compiledFilePath = join(input.compileDirectoryPath, input.copiedLogicalPath);
+    const content = await readFile(sourcePath);
+    await mkdir(dirname(compiledFilePath), {
+        recursive: true,
+    });
+    await writeFile(compiledFilePath, content);
+    return {
+        compiledPath: toArtifactRelativePath(input.appRoot, compiledFilePath),
+        content,
+        contentSha256: createContentHash(content),
+    };
+}
+function createContentHash(content) {
+    return createHash("sha256").update(content).digest("hex");
+}
+function toArtifactRelativePath(appRoot, targetPath) {
+    return normalizeLogicalPath(relative(resolve(appRoot), targetPath));
+}
+//# sourceMappingURL=resource-files.js.map

package/dist/src/compiler/resource-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-files.js","sourceRoot":"","sources":["../../../src/compiler/resource-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAWjE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,KAM9C;IACC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAC5D,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,oBAAoB,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACnF,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,CAAC;IAE3C,MAAM,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE;QACrC,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;IACH,MAAM,SAAS,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAE3C,OAAO;QACL,YAAY,EAAE,sBAAsB,CAAC,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC;QACrE,OAAO;QACP,aAAa,EAAE,iBAAiB,CAAC,OAAO,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAmB;IAC5C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,sBAAsB,CAAC,OAAe,EAAE,UAAkB;IACjE,OAAO,oBAAoB,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;AACtE,CAAC"}

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

@@ -0,0 +1,58 @@
+import { z } from "zod";
+import type { WorkspaceFileSourceRef } from "../discover/manifest.js";
+/**
+ * Stable compiled workspace artifact kind emitted by the compiler.
+ */
+export declare const WORKSPACE_RESOURCES_ARTIFACT_KIND = "ash-workspace-resources";
+/**
+ * Current compiled workspace artifact schema version.
+ */
+export declare const WORKSPACE_RESOURCES_ARTIFACT_VERSION = 1;
+/**
+ * Compiler-owned metadata for one copied authored workspace seed file.
+ */
+export interface CompiledWorkspaceFileResource {
+    byteSize: number;
+    compiledPath: string;
+    contentSha256: string;
+    logicalPath: string;
+    sourceId: string;
+}
+/**
+ * Zod schema for one compiled workspace file resource.
+ */
+export declare const compiledWorkspaceFileResourceSchema: z.ZodType<CompiledWorkspaceFileResource>;
+/**
+ * Versioned compiled workspace artifact written under `.ash/compile/`.
+ */
+export interface WorkspaceResourcesArtifact {
+    kind: typeof WORKSPACE_RESOURCES_ARTIFACT_KIND;
+    resources: CompiledWorkspaceFileResource[];
+    version: typeof WORKSPACE_RESOURCES_ARTIFACT_VERSION;
+}
+/**
+ * Zod schema for the compiled workspace resources artifact.
+ */
+export declare const workspaceResourcesArtifactSchema: z.ZodType<WorkspaceResourcesArtifact>;
+/**
+ * Input for copying authored `workspace/` seed files into compiler-owned
+ * artifacts.
+ */
+export interface WriteCompiledWorkspaceResourcesInput {
+    agentRoot: string;
+    appRoot: string;
+    compileWorkspaceDirectoryPath: string;
+    workspace: readonly WorkspaceFileSourceRef[];
+}
+/**
+ * Result of copying authored workspace seed files for compiled runtime use.
+ */
+export interface WriteCompiledWorkspaceResourcesResult {
+    artifact: WorkspaceResourcesArtifact;
+}
+/**
+ * Copies authored `workspace/` files into `.ash/compile/workspace/` and
+ * returns the compiler-owned metadata artifact for runtime hydration.
+ */
+export declare function writeCompiledWorkspaceResources(input: WriteCompiledWorkspaceResourcesInput): Promise<WriteCompiledWorkspaceResourcesResult>;
+//# sourceMappingURL=workspace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../src/compiler/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAItE;;GAEG;AACH,eAAO,MAAM,iCAAiC,4BAA4B,CAAC;AAE3E;;GAEG;AACH,eAAO,MAAM,oCAAoC,IAAI,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,mCAAmC,EAAE,CAAC,CAAC,OAAO,CAAC,6BAA6B,CAQ9E,CAAC;AAEZ;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,OAAO,iCAAiC,CAAC;IAC/C,SAAS,EAAE,6BAA6B,EAAE,CAAC;IAC3C,OAAO,EAAE,OAAO,oCAAoC,CAAC;CACtD;AAED;;GAEG;AACH,eAAO,MAAM,gCAAgC,EAAE,CAAC,CAAC,OAAO,CAAC,0BAA0B,CAMxE,CAAC;AAEZ;;;GAGG;AACH,MAAM,WAAW,oCAAoC;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B,EAAE,MAAM,CAAC;IACtC,SAAS,EAAE,SAAS,sBAAsB,EAAE,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,qCAAqC;IACpD,QAAQ,EAAE,0BAA0B,CAAC;CACtC;AAED;;;GAGG;AACH,wBAAsB,+BAA+B,CACnD,KAAK,EAAE,oCAAoC,GAC1C,OAAO,CAAC,qCAAqC,CAAC,CAqBhD"}

package/dist/src/compiler/workspace.js

@@ -0,0 +1,70 @@
+import { z } from "zod";
+import { stripWorkspaceRootLogicalPath } from "../internal/logical-paths.js";
+import { copyCompiledResourceFile } from "./resource-files.js";
+/**
+ * Stable compiled workspace artifact kind emitted by the compiler.
+ */
+export const WORKSPACE_RESOURCES_ARTIFACT_KIND = "ash-workspace-resources";
+/**
+ * Current compiled workspace artifact schema version.
+ */
+export const WORKSPACE_RESOURCES_ARTIFACT_VERSION = 1;
+/**
+ * Zod schema for one compiled workspace file resource.
+ */
+export const compiledWorkspaceFileResourceSchema = z
+    .object({
+    byteSize: z.number().finite(),
+    compiledPath: z.string(),
+    contentSha256: z.string(),
+    logicalPath: z.string(),
+    sourceId: z.string(),
+})
+    .strict();
+/**
+ * Zod schema for the compiled workspace resources artifact.
+ */
+export const workspaceResourcesArtifactSchema = z
+    .object({
+    kind: z.literal(WORKSPACE_RESOURCES_ARTIFACT_KIND),
+    resources: z.array(compiledWorkspaceFileResourceSchema),
+    version: z.literal(WORKSPACE_RESOURCES_ARTIFACT_VERSION),
+})
+    .strict();
+/**
+ * Copies authored `workspace/` files into `.ash/compile/workspace/` and
+ * returns the compiler-owned metadata artifact for runtime hydration.
+ */
+export async function writeCompiledWorkspaceResources(input) {
+    const resources = await Promise.all(input.workspace.map(async (sourceRef) => copyCompiledWorkspaceFile({
+        agentRoot: input.agentRoot,
+        appRoot: input.appRoot,
+        compileWorkspaceDirectoryPath: input.compileWorkspaceDirectoryPath,
+        sourceRef,
+    })));
+    resources.sort((left, right) => left.logicalPath.localeCompare(right.logicalPath));
+    return {
+        artifact: {
+            kind: WORKSPACE_RESOURCES_ARTIFACT_KIND,
+            resources,
+            version: WORKSPACE_RESOURCES_ARTIFACT_VERSION,
+        },
+    };
+}
+async function copyCompiledWorkspaceFile(input) {
+    const copiedFile = await copyCompiledResourceFile({
+        agentRoot: input.agentRoot,
+        appRoot: input.appRoot,
+        compileDirectoryPath: input.compileWorkspaceDirectoryPath,
+        copiedLogicalPath: stripWorkspaceRootLogicalPath(input.sourceRef.logicalPath),
+        logicalPath: input.sourceRef.logicalPath,
+    });
+    return {
+        byteSize: input.sourceRef.byteSize,
+        compiledPath: copiedFile.compiledPath,
+        contentSha256: copiedFile.contentSha256,
+        logicalPath: input.sourceRef.logicalPath,
+        sourceId: input.sourceRef.sourceId,
+    };
+}
+//# sourceMappingURL=workspace.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../../src/compiler/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAE/D;;GAEG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,yBAAyB,CAAC;AAE3E;;GAEG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC;AAatD;;GAEG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAA6C,CAAC;KAC3F,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE;IAC7B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC;KACD,MAAM,EAAE,CAAC;AAWZ;;GAEG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAA0C,CAAC;KACrF,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,iCAAiC,CAAC;IAClD,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,mCAAmC,CAAC;IACvD,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,oCAAoC,CAAC;CACzD,CAAC;KACD,MAAM,EAAE,CAAC;AAoBZ;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,KAA2C;IAE3C,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,CACtC,yBAAyB,CAAC;QACxB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,6BAA6B,EAAE,KAAK,CAAC,6BAA6B;QAClE,SAAS;KACV,CAAC,CACH,CACF,CAAC;IAEF,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;IAEnF,OAAO;QACL,QAAQ,EAAE;YACR,IAAI,EAAE,iCAAiC;YACvC,SAAS;YACT,OAAO,EAAE,oCAAoC;SAC9C;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,yBAAyB,CAAC,KAKxC;IACC,MAAM,UAAU,GAAG,MAAM,wBAAwB,CAAC;QAChD,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,oBAAoB,EAAE,KAAK,CAAC,6BAA6B;QACzD,iBAAiB,EAAE,6BAA6B,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC;QAC7E,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW;KACzC,CAAC,CAAC;IAEH,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ;QAClC,YAAY,EAAE,UAAU,CAAC,YAAY;QACrC,aAAa,EAAE,UAAU,CAAC,aAAa;QACvC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW;QACxC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ;KACnC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,35 @@
+import type { Dirent } from "node:fs";
+import { type DiscoverDiagnostic } from "./diagnostics.js";
+import { type ContextSourceRef } from "./manifest.js";
+/**
+ * Diagnostic emitted when the authored `context/` root exists but is not a
+ * directory.
+ */
+export declare 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 declare const DISCOVER_CONTEXT_ENTRY_UNSUPPORTED = "discover/context-entry-unsupported";
+type StringDirent = Dirent<string>;
+/**
+ * Input for discovering authored `context/` resources.
+ */
+export interface DiscoverContextSourcesInput {
+    agentRoot: string;
+    rootEntries: readonly StringDirent[];
+}
+/**
+ * Result of recursively discovering authored `context/` resources.
+ */
+export interface DiscoverContextSourcesResult {
+    context: ContextSourceRef[];
+    diagnostics: DiscoverDiagnostic[];
+}
+/**
+ * Discovers file-backed and module-backed resources under `context/` without
+ * executing any authored modules.
+ */
+export declare function discoverContextSources(input: DiscoverContextSourcesInput): Promise<DiscoverContextSourcesResult>;
+export {};
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/discover/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAItC,OAAO,EAAiC,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE1F,OAAO,EACL,KAAK,gBAAgB,EAGtB,MAAM,eAAe,CAAC;AAGvB;;;GAGG;AACH,eAAO,MAAM,kCAAkC,uCAAuC,CAAC;AAEvF;;;GAGG;AACH,eAAO,MAAM,kCAAkC,uCAAuC,CAAC;AAEvF,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;AAEnC;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,SAAS,YAAY,EAAE,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,4BAA4B,CAAC,CAoDvC"}