experimental-ash 0.1.0-alpha.1

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

@@ -0,0 +1,196 @@
+import { z } from "zod";
+import { type DiscoverDiagnosticsSummary } from "../discover/diagnostics.js";
+import type { ContextSourceRef, WorkspaceFileSourceRef } from "../discover/manifest.js";
+import type { ModuleSourceRef } from "../internal/source-ref.js";
+/**
+ * Stable manifest kind emitted by the compiler for runtime loading.
+ */
+export declare const COMPILED_AGENT_MANIFEST_KIND = "ash-agent-compiled-manifest";
+/**
+ * Stable node id used by compiled artifacts for the root authored agent.
+ */
+export declare const ROOT_COMPILED_AGENT_NODE_ID = "__root__";
+/**
+ * Current compiled manifest schema version.
+ */
+export declare const COMPILED_AGENT_MANIFEST_VERSION = 2;
+/**
+ * Serializable runtime model reference preserved in the compiled manifest.
+ */
+export interface CompiledRuntimeModelReference {
+    readonly id: string;
+    readonly source?: ModuleSourceRef;
+}
+/**
+ * Normalized additive agent configuration preserved in the compiled manifest.
+ */
+export interface CompiledAgentConfig {
+    readonly id?: string;
+    readonly metadata: Readonly<Record<string, string>>;
+    readonly model: CompiledRuntimeModelReference;
+    readonly source?: ModuleSourceRef;
+}
+/**
+ * Normalized prompt layer preserved in the compiled manifest.
+ */
+export interface CompiledPromptLayer {
+    readonly id: string;
+    readonly kind: "system";
+    readonly logicalPath: string;
+    readonly markdown: string;
+    readonly sourceId: string;
+    readonly sourceKind: "markdown" | "module";
+}
+/**
+ * Normalized authored skill preserved in the compiled manifest.
+ */
+export interface CompiledSkillSource {
+    readonly assetsPath?: string;
+    readonly compatibility?: string;
+    readonly description: string;
+    readonly license?: string;
+    readonly logicalPath: string;
+    readonly markdown?: string;
+    readonly metadata?: Readonly<Record<string, string>>;
+    readonly name: string;
+    readonly referencesPath?: string;
+    readonly rootPath?: string;
+    readonly scriptsPath?: string;
+    readonly skillFilePath?: string;
+    readonly skillId: string;
+    readonly sourceId: string;
+    readonly sourceKind: "markdown" | "module" | "skill-package";
+}
+/**
+ * Normalized authored schedule preserved in the compiled manifest.
+ */
+export interface CompiledScheduleDefinition {
+    readonly cron: string;
+    readonly id: string;
+    readonly logicalPath: string;
+    readonly markdown: string;
+    readonly sourceId: string;
+    readonly sourceKind: "markdown" | "module";
+}
+/**
+ * Normalized authored sandbox metadata preserved in the compiled manifest.
+ */
+export interface CompiledSandboxDefinition {
+    readonly description: string | null;
+    readonly exportName?: string;
+    readonly logicalPath: string;
+    readonly name: string;
+    readonly sourceId: string;
+    readonly sourceKind: "module";
+}
+/**
+ * Normalized authored tool metadata preserved in the compiled manifest.
+ */
+export interface CompiledToolDefinition {
+    readonly description: string;
+    readonly exportName?: string;
+    readonly inputSchema: Record<string, unknown> | null;
+    readonly logicalPath: string;
+    readonly name: string;
+    readonly sourceId: string;
+    readonly sourceKind: "module";
+}
+/**
+ * Non-recursive compiled authored agent payload shared by the root agent and
+ * every flattened subagent node.
+ */
+export interface CompiledAgentNodeManifest {
+    readonly agentId: string;
+    readonly agentRoot: string;
+    readonly appRoot: string;
+    readonly config: CompiledAgentConfig;
+    readonly context: readonly ContextSourceRef[];
+    readonly diagnosticsSummary: DiscoverDiagnosticsSummary;
+    readonly promptLayers: readonly CompiledPromptLayer[];
+    readonly sandboxes: readonly CompiledSandboxDefinition[];
+    readonly schedules: readonly CompiledScheduleDefinition[];
+    readonly skills: readonly CompiledSkillSource[];
+    readonly tools: readonly CompiledToolDefinition[];
+    readonly workspace: readonly WorkspaceFileSourceRef[];
+}
+/**
+ * Flattened compiled subagent node emitted by the compiler.
+ */
+export interface CompiledSubagentNode {
+    readonly agent: CompiledAgentNodeManifest;
+    readonly description: string;
+    readonly entryPath: string;
+    readonly inputSchema: Record<string, unknown>;
+    readonly logicalPath: string;
+    readonly name: string;
+    readonly nodeId: string;
+    readonly rootPath: string;
+    readonly sourceId: string;
+    readonly subagentId: string;
+}
+/**
+ * Parent-child edge connecting two compiled agent nodes.
+ */
+export interface CompiledSubagentEdge {
+    readonly childNodeId: string;
+    readonly parentNodeId: string;
+}
+/**
+ * Versioned compiled manifest emitted by the compiler and loaded by runtime.
+ */
+export interface CompiledAgentManifest extends CompiledAgentNodeManifest {
+    readonly kind: typeof COMPILED_AGENT_MANIFEST_KIND;
+    readonly subagentEdges: readonly CompiledSubagentEdge[];
+    readonly subagents: readonly CompiledSubagentNode[];
+    readonly version: typeof COMPILED_AGENT_MANIFEST_VERSION;
+}
+/**
+ * Zod schema for one non-recursive compiled authored agent payload.
+ */
+export declare const compiledAgentNodeManifestSchema: z.ZodType<CompiledAgentNodeManifest>;
+/**
+ * Zod schema for the versioned compiled manifest emitted by the compiler.
+ */
+export declare const compiledAgentManifestSchema: z.ZodType<CompiledAgentManifest>;
+/**
+ * Creates a compiled authored agent payload with stable defaults.
+ */
+export declare function createCompiledAgentNodeManifest(input: {
+    readonly agentId: string;
+    readonly agentRoot: string;
+    readonly appRoot: string;
+    readonly config: CompiledAgentConfig;
+    readonly context?: readonly ContextSourceRef[];
+    readonly diagnosticsSummary?: DiscoverDiagnosticsSummary;
+    readonly promptLayers?: readonly CompiledPromptLayer[];
+    readonly sandboxes?: readonly CompiledSandboxDefinition[];
+    readonly schedules?: readonly CompiledScheduleDefinition[];
+    readonly skills?: readonly CompiledSkillSource[];
+    readonly tools?: readonly CompiledToolDefinition[];
+    readonly workspace?: readonly WorkspaceFileSourceRef[];
+}): CompiledAgentNodeManifest;
+/**
+ * Creates one stable compiled subagent node id from the parent node id and the
+ * source entry discovered in that parent package.
+ */
+export declare function createCompiledSubagentNodeId(parentNodeId: string, sourceId: string): string;
+/**
+ * Creates a compiled manifest with stable defaults.
+ */
+export declare function createCompiledAgentManifest(input: {
+    readonly agentId: string;
+    readonly agentRoot: string;
+    readonly appRoot: string;
+    readonly config: CompiledAgentConfig;
+    readonly context?: readonly ContextSourceRef[];
+    readonly diagnosticsSummary?: DiscoverDiagnosticsSummary;
+    readonly promptLayers?: readonly CompiledPromptLayer[];
+    readonly sandboxes?: readonly CompiledSandboxDefinition[];
+    readonly schedules?: readonly CompiledScheduleDefinition[];
+    readonly skills?: readonly CompiledSkillSource[];
+    readonly subagentEdges?: readonly CompiledSubagentEdge[];
+    readonly subagents?: readonly CompiledSubagentNode[];
+    readonly tools?: readonly CompiledToolDefinition[];
+    readonly workspace?: readonly WorkspaceFileSourceRef[];
+}): CompiledAgentManifest;
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/compiler/manifest.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,KAAK,0BAA0B,EAEhC,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGjE;;GAEG;AACH,eAAO,MAAM,4BAA4B,gCAAgC,CAAC;AAE1E;;GAEG;AACH,eAAO,MAAM,2BAA2B,aAAa,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,+BAA+B,IAAI,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,KAAK,EAAE,6BAA6B,CAAC;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,QAAQ,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,QAAQ,GAAG,eAAe,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,QAAQ,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACrD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC9C,QAAQ,CAAC,kBAAkB,EAAE,0BAA0B,CAAC;IACxD,QAAQ,CAAC,YAAY,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACtD,QAAQ,CAAC,SAAS,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACzD,QAAQ,CAAC,SAAS,EAAE,SAAS,0BAA0B,EAAE,CAAC;IAC1D,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,SAAS,sBAAsB,EAAE,CAAC;CACvD;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,yBAAyB,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,yBAAyB;IACtE,QAAQ,CAAC,IAAI,EAAE,OAAO,4BAA4B,CAAC;IACnD,QAAQ,CAAC,aAAa,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACxD,QAAQ,CAAC,SAAS,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACpD,QAAQ,CAAC,OAAO,EAAE,OAAO,+BAA+B,CAAC;CAC1D;AAoHD;;GAEG;AACH,eAAO,MAAM,+BAA+B,EAAE,CAAC,CAAC,OAAO,CAAC,yBAAyB,CAetE,CAAC;AAwBZ;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAmB9D,CAAC;AAEZ;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC/C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,0BAA0B,CAAC;IACzD,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACvD,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,0BAA0B,EAAE,CAAC;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;CACxD,GAAG,yBAAyB,CAwC5B;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM3F;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC/C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,0BAA0B,CAAC;IACzD,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACvD,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,0BAA0B,EAAE,CAAC;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACjD,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACrD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;CACxD,GAAG,qBAAqB,CAQxB"}

package/dist/src/compiler/manifest.js

@@ -0,0 +1,246 @@
+import { resolve } from "node:path";
+import { z } from "zod";
+import { discoverDiagnosticsSummarySchema, } from "../discover/diagnostics.js";
+import { jsonObjectSchema } from "../runtime/json.js";
+/**
+ * Stable manifest kind emitted by the compiler for runtime loading.
+ */
+export const COMPILED_AGENT_MANIFEST_KIND = "ash-agent-compiled-manifest";
+/**
+ * Stable node id used by compiled artifacts for the root authored agent.
+ */
+export const ROOT_COMPILED_AGENT_NODE_ID = "__root__";
+/**
+ * Current compiled manifest schema version.
+ */
+export const COMPILED_AGENT_MANIFEST_VERSION = 2;
+const moduleSourceRefSchema = z
+    .object({
+    exportName: z.string().optional(),
+    kind: z.literal("module"),
+    logicalPath: z.string(),
+    sourceId: z.string(),
+})
+    .strict();
+const contextFileSourceRefSchema = z
+    .object({
+    byteSize: z.number().finite(),
+    kind: z.literal("context-file"),
+    logicalPath: z.string(),
+    mediaType: z.string(),
+    sourceId: z.string(),
+})
+    .strict();
+const contextSourceRefSchema = z.union([
+    contextFileSourceRefSchema,
+    moduleSourceRefSchema,
+]);
+const workspaceFileSourceRefSchema = z
+    .object({
+    byteSize: z.number().finite(),
+    kind: z.literal("workspace-file"),
+    logicalPath: z.string(),
+    sourceId: z.string(),
+})
+    .strict();
+const compiledRuntimeModelReferenceSchema = z
+    .object({
+    id: z.string(),
+    source: moduleSourceRefSchema.optional(),
+})
+    .strict();
+const compiledAgentConfigSchema = z
+    .object({
+    id: z.string().optional(),
+    metadata: z.record(z.string(), z.string()),
+    model: compiledRuntimeModelReferenceSchema,
+    source: moduleSourceRefSchema.optional(),
+})
+    .strict();
+const compiledPromptLayerSchema = z
+    .object({
+    id: z.string(),
+    kind: z.literal("system"),
+    logicalPath: z.string(),
+    markdown: z.string(),
+    sourceId: z.string(),
+    sourceKind: z.union([z.literal("markdown"), z.literal("module")]),
+})
+    .strict();
+const compiledSkillSourceSchema = z
+    .object({
+    assetsPath: z.string().optional(),
+    compatibility: z.string().optional(),
+    description: z.string(),
+    license: z.string().optional(),
+    logicalPath: z.string(),
+    markdown: z.string().optional(),
+    metadata: z.record(z.string(), z.string()).optional(),
+    name: z.string(),
+    referencesPath: z.string().optional(),
+    rootPath: z.string().optional(),
+    scriptsPath: z.string().optional(),
+    skillFilePath: z.string().optional(),
+    skillId: z.string(),
+    sourceId: z.string(),
+    sourceKind: z.union([z.literal("markdown"), z.literal("module"), z.literal("skill-package")]),
+})
+    .strict();
+const compiledScheduleDefinitionSchema = z
+    .object({
+    cron: z.string(),
+    id: z.string(),
+    logicalPath: z.string(),
+    markdown: z.string(),
+    sourceId: z.string(),
+    sourceKind: z.union([z.literal("markdown"), z.literal("module")]),
+})
+    .strict();
+const compiledSandboxDefinitionSchema = z
+    .object({
+    description: z.string().nullable(),
+    exportName: z.string().optional(),
+    logicalPath: z.string(),
+    name: z.string(),
+    sourceId: z.string(),
+    sourceKind: z.literal("module"),
+})
+    .strict();
+const compiledToolDefinitionSchema = z
+    .object({
+    description: z.string(),
+    exportName: z.string().optional(),
+    inputSchema: jsonObjectSchema.nullable(),
+    logicalPath: z.string(),
+    name: z.string(),
+    sourceId: z.string(),
+    sourceKind: z.literal("module"),
+})
+    .strict();
+/**
+ * Zod schema for one non-recursive compiled authored agent payload.
+ */
+export const compiledAgentNodeManifestSchema = z
+    .object({
+    agentId: z.string(),
+    agentRoot: z.string(),
+    appRoot: z.string(),
+    config: compiledAgentConfigSchema,
+    context: z.array(contextSourceRefSchema),
+    diagnosticsSummary: discoverDiagnosticsSummarySchema,
+    promptLayers: z.array(compiledPromptLayerSchema),
+    sandboxes: z.array(compiledSandboxDefinitionSchema),
+    schedules: z.array(compiledScheduleDefinitionSchema),
+    skills: z.array(compiledSkillSourceSchema),
+    tools: z.array(compiledToolDefinitionSchema),
+    workspace: z.array(workspaceFileSourceRefSchema),
+})
+    .strict();
+const compiledSubagentNodeSchema = z
+    .object({
+    agent: compiledAgentNodeManifestSchema,
+    description: z.string(),
+    entryPath: z.string(),
+    inputSchema: jsonObjectSchema,
+    logicalPath: z.string(),
+    name: z.string(),
+    nodeId: z.string(),
+    rootPath: z.string(),
+    sourceId: z.string(),
+    subagentId: z.string(),
+})
+    .strict();
+const compiledSubagentEdgeSchema = z
+    .object({
+    childNodeId: z.string(),
+    parentNodeId: z.string(),
+})
+    .strict();
+/**
+ * Zod schema for the versioned compiled manifest emitted by the compiler.
+ */
+export const compiledAgentManifestSchema = z
+    .object({
+    agentId: z.string(),
+    agentRoot: z.string(),
+    appRoot: z.string(),
+    config: compiledAgentConfigSchema,
+    context: z.array(contextSourceRefSchema),
+    diagnosticsSummary: discoverDiagnosticsSummarySchema,
+    kind: z.literal(COMPILED_AGENT_MANIFEST_KIND),
+    promptLayers: z.array(compiledPromptLayerSchema),
+    sandboxes: z.array(compiledSandboxDefinitionSchema),
+    schedules: z.array(compiledScheduleDefinitionSchema),
+    skills: z.array(compiledSkillSourceSchema),
+    subagentEdges: z.array(compiledSubagentEdgeSchema),
+    subagents: z.array(compiledSubagentNodeSchema),
+    tools: z.array(compiledToolDefinitionSchema),
+    version: z.literal(COMPILED_AGENT_MANIFEST_VERSION),
+    workspace: z.array(workspaceFileSourceRefSchema),
+})
+    .strict();
+/**
+ * Creates a compiled authored agent payload with stable defaults.
+ */
+export function createCompiledAgentNodeManifest(input) {
+    return {
+        agentId: input.agentId,
+        agentRoot: resolve(input.agentRoot),
+        appRoot: resolve(input.appRoot),
+        config: {
+            ...input.config,
+            metadata: {
+                ...input.config.metadata,
+            },
+            model: input.config.model.source === undefined
+                ? {
+                    id: input.config.model.id,
+                }
+                : {
+                    id: input.config.model.id,
+                    source: {
+                        ...input.config.model.source,
+                    },
+                },
+            source: input.config.source === undefined
+                ? undefined
+                : {
+                    ...input.config.source,
+                },
+        },
+        context: [...(input.context ?? [])],
+        diagnosticsSummary: input.diagnosticsSummary ?? {
+            errors: 0,
+            warnings: 0,
+        },
+        promptLayers: [...(input.promptLayers ?? [])],
+        sandboxes: [...(input.sandboxes ?? [])],
+        schedules: [...(input.schedules ?? [])],
+        skills: [...(input.skills ?? [])],
+        tools: [...(input.tools ?? [])],
+        workspace: [...(input.workspace ?? [])],
+    };
+}
+/**
+ * Creates one stable compiled subagent node id from the parent node id and the
+ * source entry discovered in that parent package.
+ */
+export function createCompiledSubagentNodeId(parentNodeId, sourceId) {
+    if (parentNodeId === ROOT_COMPILED_AGENT_NODE_ID) {
+        return sourceId;
+    }
+    return `${parentNodeId}::${sourceId}`;
+}
+/**
+ * Creates a compiled manifest with stable defaults.
+ */
+export function createCompiledAgentManifest(input) {
+    return {
+        ...createCompiledAgentNodeManifest(input),
+        kind: COMPILED_AGENT_MANIFEST_KIND,
+        subagentEdges: [...(input.subagentEdges ?? [])],
+        subagents: [...(input.subagents ?? [])],
+        version: COMPILED_AGENT_MANIFEST_VERSION,
+    };
+}
+//# sourceMappingURL=manifest.js.map

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

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

package/dist/src/compiler/module-map.d.ts

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import type { CompiledAgentManifest } from "./manifest.js";
+/**
+ * Compiled module ownership for one runtime graph node.
+ */
+export interface CompiledModuleNodeScope {
+    readonly modules: Record<string, unknown>;
+}
+/**
+ * Flattened compiled authored module map keyed by stable node ids.
+ */
+export interface CompiledModuleMap {
+    readonly nodes: Record<string, CompiledModuleNodeScope>;
+}
+/**
+ * Zod schema for the flattened compiled authored module map.
+ */
+export declare const compiledModuleMapSchema: z.ZodType<CompiledModuleMap>;
+/**
+ * Input for generating the compiled authored module map artifact.
+ */
+export interface CreateCompiledModuleMapSourceInput {
+    /**
+     * Controls how generated authored-module imports are written. Relative
+     * specifiers are the compiler default; absolute specifiers are useful when a
+     * bundler consumes the module map from a virtual module id.
+     */
+    importSpecifierStyle?: "absolute" | "relative";
+    manifest: CompiledAgentManifest;
+    moduleMapPath: string;
+}
+/**
+ * Generates the compiler-owned module map artifact that statically imports
+ * every module-backed authored source.
+ */
+export declare function createCompiledModuleMapSource(input: CreateCompiledModuleMapSourceInput): string;
+//# sourceMappingURL=module-map.d.ts.map

package/dist/src/compiler/module-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-map.d.ts","sourceRoot":"","sources":["../../../src/compiler/module-map.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,qBAAqB,EAA6B,MAAM,eAAe,CAAC;AAGtF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;CACzD;AAQD;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAItD,CAAC;AAEZ;;GAEG;AACH,MAAM,WAAW,kCAAkC;IACjD;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;IAC/C,QAAQ,EAAE,qBAAqB,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;CACvB;AAaD;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,kCAAkC,GAAG,MAAM,CA8C/F"}

package/dist/src/compiler/module-map.js

@@ -0,0 +1,148 @@
+import { join, relative, resolve } from "node:path";
+import { z } from "zod";
+import { normalizeLogicalPath } from "../discover/filesystem.js";
+import { ROOT_COMPILED_AGENT_NODE_ID } from "./manifest.js";
+const compiledModuleNodeScopeSchema = z
+    .object({
+    modules: z.record(z.string(), z.object({}).passthrough()),
+})
+    .strict();
+/**
+ * Zod schema for the flattened compiled authored module map.
+ */
+export const compiledModuleMapSchema = z
+    .object({
+    nodes: z.record(z.string(), compiledModuleNodeScopeSchema),
+})
+    .strict();
+/**
+ * Generates the compiler-owned module map artifact that statically imports
+ * every module-backed authored source.
+ */
+export function createCompiledModuleMapSource(input) {
+    const moduleMapDirectory = resolve(input.moduleMapPath, "..");
+    const importSpecifierStyle = input.importSpecifierStyle ?? "relative";
+    let nextBindingIndex = 0;
+    const collectedScopes = [
+        collectModuleNodeScope({
+            agentRoot: input.manifest.agentRoot,
+            importSpecifierStyle,
+            manifest: input.manifest,
+            moduleMapDirectory,
+            nextBindingName() {
+                return `module_${nextBindingIndex++}`;
+            },
+            nodeId: ROOT_COMPILED_AGENT_NODE_ID,
+        }),
+        ...[...input.manifest.subagents]
+            .sort((left, right) => left.nodeId.localeCompare(right.nodeId))
+            .map((subagent) => collectModuleNodeScope({
+            agentRoot: subagent.agent.agentRoot,
+            importSpecifierStyle,
+            manifest: subagent.agent,
+            moduleMapDirectory,
+            nextBindingName() {
+                return `module_${nextBindingIndex++}`;
+            },
+            nodeId: subagent.nodeId,
+        })),
+    ];
+    const imports = collectedScopes.flatMap((scope) => scope.modules.map((moduleImport) => {
+        return `import * as ${moduleImport.bindingName} from ${JSON.stringify(moduleImport.importSpecifier)};`;
+    }));
+    return [
+        "// Generated by Ash. Do not edit by hand.",
+        "",
+        ...imports,
+        ...(imports.length > 0 ? [""] : []),
+        `export const moduleMap = ${renderModuleMap(collectedScopes)};`,
+        "",
+        "export default moduleMap;",
+        "",
+    ].join("\n");
+}
+function collectModuleNodeScope(input) {
+    return {
+        modules: collectModuleRefsForManifest(input.manifest)
+            .sort((left, right) => left.sourceId.localeCompare(right.sourceId))
+            .map((moduleSourceRef) => ({
+            bindingName: input.nextBindingName(),
+            importSpecifier: createImportSpecifier({
+                fromDirectory: input.moduleMapDirectory,
+                importSpecifierStyle: input.importSpecifierStyle,
+                targetPath: join(input.agentRoot, moduleSourceRef.logicalPath),
+            }),
+            sourceId: moduleSourceRef.sourceId,
+        })),
+        nodeId: input.nodeId,
+    };
+}
+function collectModuleRefsForManifest(manifest) {
+    const moduleSourceRefs = [];
+    if (manifest.config.model.source !== undefined) {
+        moduleSourceRefs.push(manifest.config.model.source);
+    }
+    for (const tool of manifest.tools) {
+        moduleSourceRefs.push({
+            exportName: tool.exportName,
+            kind: "module",
+            logicalPath: tool.logicalPath,
+            sourceId: tool.sourceId,
+        });
+    }
+    for (const sandbox of manifest.sandboxes) {
+        moduleSourceRefs.push({
+            exportName: sandbox.exportName,
+            kind: "module",
+            logicalPath: sandbox.logicalPath,
+            sourceId: sandbox.sourceId,
+        });
+    }
+    return moduleSourceRefs;
+}
+function createImportSpecifier(input) {
+    if (input.importSpecifierStyle === "absolute") {
+        return resolve(input.targetPath).replaceAll("\\", "/");
+    }
+    const relativeSpecifier = normalizeLogicalPath(relative(resolve(input.fromDirectory), resolve(input.targetPath)));
+    if (relativeSpecifier.startsWith(".")) {
+        return relativeSpecifier;
+    }
+    return `./${relativeSpecifier}`;
+}
+function renderModuleMap(scopes) {
+    return renderFrozenObject([
+        {
+            key: "nodes",
+            value: renderFrozenObject(scopes.map((scope) => ({
+                key: scope.nodeId,
+                value: renderFrozenObject([
+                    {
+                        key: "modules",
+                        value: renderFrozenObject(scope.modules.map((moduleImport) => ({
+                            key: moduleImport.sourceId,
+                            value: moduleImport.bindingName,
+                        }))),
+                    },
+                ], 3),
+            }))),
+        },
+    ], 0);
+}
+function renderFrozenObject(entries, depth = 1) {
+    if (entries.length === 0) {
+        return "Object.freeze({})";
+    }
+    const indentation = "  ".repeat(depth);
+    const nestedIndentation = "  ".repeat(depth + 1);
+    return [
+        "Object.freeze({",
+        entries
+            .map((entry) => {
+            return `${nestedIndentation}${JSON.stringify(entry.key)}: ${entry.value.replaceAll("\n", `\n${nestedIndentation}`)}`;
+        })
+            .join(",\n"),
+        `${indentation}})`,
+    ].join("\n");
+}
+//# sourceMappingURL=module-map.js.map

package/dist/src/compiler/module-map.js.map

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