eve 0.44.4 → 0.45.0

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

@@ -1,48 +1,30 @@
 import { z } from "#compiled/zod/index.js";
-import type { ModuleSourceRef } from "#shared/source-ref.js";
 import type { CompiledAgentManifest, CompiledAgentNodeManifest, CompiledAgentResources } from "#compiler/manifest.js";
-/**
- * Compiled module ownership for one runtime graph node.
- */
+import { type AgentSourceRegistry, type CompiledModuleBinding } from "#compiler/source-graph.js";
+export { resolveCompiledModuleExtensionScopeNamespace } from "#compiler/load-binding-namespace.js";
 export type CompiledModuleNodeScope = z.infer<typeof compiledModuleNodeScopeSchema>;
-/**
- * Flattened compiled authored module map keyed by stable node ids.
- */
 export type CompiledModuleMap = z.infer<typeof compiledModuleMapSchema>;
 declare const compiledModuleNodeScopeSchema: z.ZodObject<{
     modules: z.ZodRecord<z.ZodString, z.ZodObject<{}, z.core.$loose>>;
 }, z.core.$strict>;
-/**
- * Zod schema for the flattened compiled authored module map.
- */
 export declare const compiledModuleMapSchema: z.ZodObject<{
     nodes: z.ZodRecord<z.ZodString, z.ZodObject<{
         modules: z.ZodRecord<z.ZodString, z.ZodObject<{}, z.core.$loose>>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
-/**
- * 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;
+    programmaticLoaderImportSpecifier?: string;
 }
-/**
- * Generates the compiler-owned module map artifact that statically imports
- * every module-backed authored source.
- */
+interface BoundModule {
+    readonly binding: CompiledModuleBinding;
+    readonly sourceId: string;
+}
+/** Generates the authoritative module-map artifact from required bindings. */
 export declare function createCompiledModuleMapSource(input: CreateCompiledModuleMapSourceInput): string;
-/**
- * Collects every module-backed source reference from a single compiled
- * agent node manifest. Used by both the compiler (to generate the static
- * module-map artifact) and the runtime loader (to hydrate a module map
- * from the manifest when the pre-built artifact is unavailable).
- */
-export declare function collectModuleRefsForManifest(manifest: CompiledAgentNodeManifest | CompiledAgentResources): ModuleSourceRef[];
-export {};
+/** Loads the same binding set used by generated maps without fabricating descriptors. */
+export declare function createProgrammaticCompiledModuleMap(manifest: CompiledAgentManifest, registries: readonly AgentSourceRegistry[]): Promise<CompiledModuleMap>;
+/** Returns every binding owned by one compiled node, including remote config modules. */
+export declare function collectModuleBindingsForManifest(manifest: CompiledAgentNodeManifest | CompiledAgentResources): readonly BoundModule[];

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

@@ -1,5 +1,5 @@
-import{z}from"#compiled/zod/index.js";import{ROOT_COMPILED_AGENT_NODE_ID}from"#compiler/manifest.js";import{normalizeEsmImportSpecifier}from"#internal/application/import-specifier.js";const compiledModuleNodeScopeSchema=z.object({modules:z.record(z.string(),z.object({}).passthrough())}).strict(),compiledModuleMapSchema=z.object({nodes:z.record(z.string(),compiledModuleNodeScopeSchema)}).strict();function createCompiledModuleMapSource(e){let n=dirnameFilesystemPath(e.moduleMapPath),r=e.importSpecifierStyle??`relative`,i=0,a=[collectModuleNodeScope({agentRoot:e.manifest.agentRoot,importSpecifierStyle:r,manifest:e.manifest,moduleMapDirectory:n,nextBindingName(){return`module_${i++}`},nodeId:ROOT_COMPILED_AGENT_NODE_ID}),...[...e.manifest.subagents].sort((e,t)=>e.nodeId.localeCompare(t.nodeId)).map(e=>collectModuleNodeScope({agentRoot:e.agent.agentRoot,importSpecifierStyle:r,manifest:e.agent,additionalModuleRef:e.configResolver,moduleMapDirectory:n,nextBindingName(){return`module_${i++}`},nodeId:e.nodeId}))],o=a.flatMap(e=>e.modules).map(e=>`import * as ${e.bindingName} from ${JSON.stringify(e.importSpecifier)};`);return[`// Generated by eve. Do not edit by hand.`,``,...o,...o.length>0?[``]:[],`export const moduleMap = ${renderModuleMap(a)};`,``,`export default moduleMap;`,``].join(`
-`)}function collectModuleNodeScope(e){return{modules:[...collectModuleRefsForManifest(e.manifest),...e.additionalModuleRef===void 0?[]:[e.additionalModuleRef]].sort((e,t)=>e.sourceId.localeCompare(t.sourceId)).map(t=>({bindingName:e.nextBindingName(),importSpecifier:createImportSpecifier({fromDirectory:e.moduleMapDirectory,importSpecifierStyle:e.importSpecifierStyle,targetPath:joinFilesystemPath(e.agentRoot,t.logicalPath)}),sourceId:t.sourceId})),nodeId:e.nodeId}}function collectModuleRefsForManifest(e){let t=new Map;`config`in e&&e.config.source!==void 0&&t.set(e.config.source.sourceId,e.config.source),`config`in e&&e.config.model?.source!==void 0&&t.set(e.config.model.source.sourceId,e.config.model.source);for(let n of e.channels)n.kind!==`disabled`&&t.set(n.sourceId,{exportName:n.exportName,sourceKind:`module`,logicalPath:n.logicalPath,sourceId:n.sourceId});for(let n of e.connections)t.set(n.sourceId,{exportName:n.exportName,sourceKind:`module`,logicalPath:n.logicalPath,sourceId:n.sourceId});for(let n of e.tools)t.set(n.sourceId,{exportName:n.exportName,sourceKind:`module`,logicalPath:n.logicalPath,sourceId:n.sourceId});for(let n of e.dynamicInstructions)t.set(n.sourceId,{exportName:n.exportName,sourceKind:`module`,logicalPath:n.logicalPath,sourceId:n.sourceId});for(let n of e.dynamicSkills)t.set(n.sourceId,{exportName:n.exportName,sourceKind:`module`,logicalPath:n.logicalPath,sourceId:n.sourceId});for(let n of e.dynamicTools)t.set(n.sourceId,{exportName:n.exportName,sourceKind:`module`,logicalPath:n.logicalPath,sourceId:n.sourceId});for(let n of e.remoteAgents)t.set(n.sourceId,{exportName:n.exportName,sourceKind:`module`,logicalPath:n.logicalPath,sourceId:n.sourceId});for(let n of e.hooks)t.set(n.sourceId,{exportName:n.exportName,sourceKind:`module`,logicalPath:n.logicalPath,sourceId:n.sourceId});for(let n of e.schedules)n.sourceKind!==`module`||!n.hasRun||t.set(n.sourceId,{sourceKind:`module`,logicalPath:n.logicalPath,sourceId:n.sourceId});e.sandbox!==null&&t.set(e.sandbox.sourceId,{exportName:e.sandbox.exportName,sourceKind:`module`,logicalPath:e.sandbox.logicalPath,sourceId:e.sandbox.sourceId});let n=e.extensionMounts;if(n!==void 0)for(let e of n)t.set(e.mountSourceId,{sourceKind:`module`,logicalPath:e.mountLogicalPath,sourceId:e.mountSourceId});return[...t.values()]}function createImportSpecifier(e){if(e.importSpecifierStyle===`absolute`)return normalizeEsmImportSpecifier(normalizeFilesystemPath(e.targetPath));let t=relativeFilesystemPath(e.fromDirectory,e.targetPath);return t.startsWith(`.`)?t:`./${t}`}function renderModuleMap(e){return renderFrozenObject([{key:`nodes`,value:renderFrozenObject(e.map(e=>({key:e.nodeId,value:renderFrozenObject([{key:`modules`,value:renderFrozenObject(e.modules.map(e=>({key:e.sourceId,value:e.bindingName})))}],3)})))}],0)}function renderFrozenObject(e,t=1){if(e.length===0)return`Object.freeze({})`;let n=`  `.repeat(t),r=`  `.repeat(t+1);return[`Object.freeze({`,e.map(e=>`${r}${JSON.stringify(e.key)}: ${e.value.replaceAll(`
+import{z}from"#compiled/zod/index.js";import{createCompiledBindingNamespaceLoader,resolveCompiledModuleExtensionScopeNamespace}from"#compiler/load-binding-namespace.js";import{ROOT_COMPILED_AGENT_NODE_ID}from"#compiler/manifest.js";import"#compiler/source-graph.js";import{normalizeEsmImportSpecifier}from"#internal/application/import-specifier.js";const compiledModuleNodeScopeSchema=z.object({modules:z.record(z.string(),z.object({}).passthrough())}).strict(),compiledModuleMapSchema=z.object({nodes:z.record(z.string(),compiledModuleNodeScopeSchema)}).strict();function createCompiledModuleMapSource(e){let t=dirnameFilesystemPath(e.moduleMapPath),n=e.importSpecifierStyle??`relative`,r=0,a=!1,o=collectBoundNodeScopes(e.manifest).map(e=>{let i=new Map(e.modules.map(e=>[e.sourceId,`module_${r++}`]));return{modules:e.modules.map(({binding:e,sourceId:r})=>{let o=i.get(r);return e.backing.kind===`filesystem`?{bindingName:o,importSpecifier:createImportSpecifier({fromDirectory:t,importSpecifierStyle:n,targetPath:e.backing.sourcePath}),sourceId:r}:(a=!0,{bindingName:o,initializer:`await loadProgrammaticModule(${JSON.stringify(e.backing)}, ${renderProgrammaticDependencies(e.backing.dependencies,i)})`,sourceId:r})}),nodeId:e.nodeId}}),s=o.flatMap(e=>e.modules),c=s.flatMap(e=>e.importSpecifier===void 0?[]:[`import * as ${e.bindingName} from ${JSON.stringify(e.importSpecifier)};`]),l=s.flatMap(e=>e.initializer===void 0?[]:[`const ${e.bindingName} = ${e.initializer};`]);return[`// Generated by eve. Do not edit by hand.`,...a?[`import { loadFrameworkProgrammaticModule as loadProgrammaticModule } from ${JSON.stringify(normalizeEsmImportSpecifier(e.programmaticLoaderImportSpecifier??`eve/internal/programmatic-source-loader`))};`]:[],...c,...a||c.length>0?[``]:[],...l,...l.length>0?[``]:[],`export const moduleMap = ${renderModuleMap(o)};`,``,`export default moduleMap;`,``].join(`
+`)}async function createProgrammaticCompiledModuleMap(e,n){let r={};for(let i of collectBoundNodeScopes(e)){let e={},a=createCompiledBindingNamespaceLoader({bindings:Object.fromEntries(i.modules.map(({binding:e,sourceId:t})=>[t,e])),registries:n});for(let{sourceId:t}of i.modules)e[t]=await a(t);r[i.nodeId]={modules:e}}return{nodes:r}}function collectModuleBindingsForManifest(e){let t=new Map(Object.entries(e.bindings));for(let n of e.remoteAgents){if(t.has(n.sourceId))throw Error(`Remote agent binding "${n.sourceId}" collides with a node binding.`);t.set(n.sourceId,n.binding)}return orderBoundModules([...t].sort(([e],[t])=>e.localeCompare(t)).map(([e,t])=>({binding:t,sourceId:e})))}function orderBoundModules(e){let t=new Map(e.map(e=>[e.sourceId,e])),n=[],r=new Set,i=new Set,visit=e=>{if(!i.has(e.sourceId)){if(r.has(e.sourceId))throw Error(`Compiled module dependency cycle includes "${e.sourceId}".`);if(r.add(e.sourceId),e.binding.backing.kind===`programmatic`)for(let n of Object.values(e.binding.backing.dependencies??{})){let r=t.get(n);if(r===void 0)throw Error(`Programmatic binding "${e.sourceId}" depends on missing binding "${n}".`);visit(r)}r.delete(e.sourceId),i.add(e.sourceId),n.push(e)}};for(let t of e)visit(t);return n}function renderProgrammaticDependencies(e,t){let n=Object.entries(e??{});return n.length===0?`Object.freeze({})`:`Object.freeze({ ${n.map(([e,n])=>`${JSON.stringify(e)}: ${t.get(n)}`).join(`, `)} })`}function collectBoundNodeScopes(e){return[{modules:collectModuleBindingsForManifest(e),nodeId:ROOT_COMPILED_AGENT_NODE_ID},...[...e.subagents].sort((e,t)=>e.nodeId.localeCompare(t.nodeId)).map(e=>({modules:collectModuleBindingsForManifest(e.agent),nodeId:e.nodeId}))]}function renderModuleMap(e){return renderFrozenObject([{key:`nodes`,value:renderFrozenObject(e.map(e=>({key:e.nodeId,value:renderFrozenObject([{key:`modules`,value:renderFrozenObject(e.modules.map(e=>({key:e.sourceId,value:e.bindingName})))}],3)})))}],0)}function renderFrozenObject(e,t=1){if(e.length===0)return`Object.freeze({})`;let n=`  `.repeat(t),r=`  `.repeat(t+1);return[`Object.freeze({`,e.map(e=>`${r}${JSON.stringify(e.key)}: ${e.value.replaceAll(`
 `,`\n${r}`)}`).join(`,
 `),`${n}})`].join(`
-`)}function dirnameFilesystemPath(e){let t=splitFilesystemPath(e);return t.segments.length===0?t.root.length===0?`.`:t.root:createFilesystemPath(t.root,t.segments.slice(0,-1))}function joinFilesystemPath(e,t){let n=splitFilesystemPath(e),r=splitFilesystemPath(t);return r.root.length>0?createFilesystemPath(r.root,r.segments):createFilesystemPath(n.root,[...n.segments,...r.segments])}function relativeFilesystemPath(e,t){let n=splitFilesystemPath(e),r=splitFilesystemPath(t);if(n.root!==r.root)return normalizeFilesystemPath(t);let i=0;for(;i<n.segments.length&&i<r.segments.length&&n.segments[i]===r.segments[i];)i+=1;let a=[...Array.from({length:n.segments.length-i},()=>`..`),...r.segments.slice(i)];return a.length===0?`.`:a.join(`/`)}function normalizeFilesystemPath(e){let t=splitFilesystemPath(e);return createFilesystemPath(t.root,t.segments)}function splitFilesystemPath(e){let t=e.replaceAll(`\\`,`/`),n=``,r=t,i=t.match(/^[A-Za-z]:/);i===null?t.startsWith(`/`)&&(n=`/`,r=t.slice(1)):(n=i[0],r=t.slice(n.length),r.startsWith(`/`)&&(n=`${n}/`,r=r.slice(1)));let a=[];for(let e of r.split(`/`))if(!(e.length===0||e===`.`)){if(e===`..`){if(a.length>0&&a[a.length-1]!==`..`){a.pop();continue}n.length===0&&a.push(e);continue}a.push(e)}return{root:n,segments:a}}function createFilesystemPath(e,t){return e===`/`?t.length===0?`/`:`/${t.join(`/`)}`:e.endsWith(`/`)?t.length===0?e:`${e}${t.join(`/`)}`:e.length>0?t.length===0?e:`${e}/${t.join(`/`)}`:t.length===0?`.`:t.join(`/`)}export{collectModuleRefsForManifest,compiledModuleMapSchema,createCompiledModuleMapSource};
+`)}function createImportSpecifier(e){if(e.importSpecifierStyle===`absolute`)return normalizeEsmImportSpecifier(normalizeFilesystemPath(e.targetPath));let t=relativeFilesystemPath(e.fromDirectory,e.targetPath);return t.startsWith(`.`)?t:`./${t}`}function dirnameFilesystemPath(e){let t=splitFilesystemPath(e);return t.segments.length===0?t.root.length===0?`.`:t.root:createFilesystemPath(t.root,t.segments.slice(0,-1))}function relativeFilesystemPath(e,t){let n=splitFilesystemPath(e),r=splitFilesystemPath(t);if(n.root!==r.root)return normalizeFilesystemPath(t);let i=0;for(;i<n.segments.length&&i<r.segments.length&&n.segments[i]===r.segments[i];)i+=1;return[...Array.from({length:n.segments.length-i},()=>`..`),...r.segments.slice(i)].join(`/`)||`.`}function normalizeFilesystemPath(e){let t=splitFilesystemPath(e);return createFilesystemPath(t.root,t.segments)}function splitFilesystemPath(e){let t=e.replaceAll(`\\`,`/`),n=``,r=t,i=t.match(/^[A-Za-z]:/);i===null?t.startsWith(`/`)&&(n=`/`,r=t.slice(1)):(n=i[0],r=t.slice(n.length),r.startsWith(`/`)&&(n+=`/`,r=r.slice(1)));let a=[];for(let e of r.split(`/`))e.length===0||e===`.`||(e===`..`?a.length>0&&a.at(-1)!==`..`?a.pop():n.length===0&&a.push(e):a.push(e));return{root:n,segments:a}}function createFilesystemPath(e,t){return e===`/`?t.length===0?`/`:`/${t.join(`/`)}`:e.endsWith(`/`)?t.length===0?e:`${e}${t.join(`/`)}`:e.length>0?t.length===0?e:`${e}/${t.join(`/`)}`:t.length===0?`.`:t.join(`/`)}export{collectModuleBindingsForManifest,compiledModuleMapSchema,createCompiledModuleMapSource,createProgrammaticCompiledModuleMap,resolveCompiledModuleExtensionScopeNamespace};

package/dist/src/compiler/node-source-state.d.ts

@@ -0,0 +1,24 @@
+import type { ModuleSourceRef } from "#shared/source-ref.js";
+import type { ProjectedAgentSources, ProjectedSource, ProjectedSubagentSource } from "#compiler/project-sources.js";
+import { type AgentModuleCandidate, type AgentSourceCandidate, type ComposedAgentModuleCandidates, type CompiledModuleBinding } from "#compiler/source-graph.js";
+export interface ComposedNodeSourceGraph {
+    composed: ComposedAgentModuleCandidates;
+    readonly orderedCandidates: readonly AgentSourceCandidate[];
+    readonly projected: ProjectedAgentSources;
+    readonly sourcesBySourceId: ReadonlyMap<string, ProjectedSource>;
+    readonly subagentsBySourceId: ReadonlyMap<string, ProjectedSubagentSource>;
+}
+export interface SelectedNodeConfig {
+    readonly binding: CompiledModuleBinding;
+    readonly candidate: AgentModuleCandidate;
+    readonly definition: unknown;
+    readonly source: ModuleSourceRef;
+}
+export interface PhaseOneNodeSourceState {
+    readonly graph: ComposedNodeSourceGraph;
+    readonly selectedConfig: SelectedNodeConfig;
+}
+export interface FinalizedNodeSourceState extends ComposedNodeSourceGraph {
+    readonly bindings: Record<string, CompiledModuleBinding>;
+}
+export declare function finalizeNodeSourceState(phaseOne: PhaseOneNodeSourceState, externalDependencies: readonly string[]): FinalizedNodeSourceState;

package/dist/src/compiler/node-source-state.js

@@ -0,0 +1 @@
+import{createCompiledModuleBinding}from"#compiler/source-graph.js";import{collectSelectedSourceIds,mergeExternalDependencies}from"#compiler/normalize-manifest-helpers.js";function finalizeNodeSourceState(n,r){let i=n.graph,a=new Map(i.orderedCandidates.map(e=>{let t=finalizeCandidateExternalDependencies(e,r);return[e.sourceId,t]})),candidateFor=e=>{let t=a.get(e.sourceId);if(t===void 0)throw Error(`Agent source candidate "${e.sourceId}" is missing from its node.`);return t},o={candidates:i.projected.candidates.map(candidateFor),resources:i.projected.resources.map(e=>({...e,candidate:candidateFor(e.candidate)})),subagents:i.projected.subagents.map(e=>({...e,candidate:candidateFor(e.candidate)}))},s={composition:{entries:i.composed.composition.entries.map(e=>({...e,source:finalizeDescriptorExternalDependencies(e.source,r)}))},selected:new Map([...i.composed.selected].map(([e,t])=>[e,candidateFor(t)]))},c=collectSelectedSourceIds(s);return{bindings:Object.fromEntries([...a.values()].filter(e=>c.has(e.sourceId)&&e.backing.kind!==`resource`).map(t=>[t.sourceId,createCompiledModuleBinding(t)])),composed:s,orderedCandidates:i.orderedCandidates.map(candidateFor),projected:o,sourcesBySourceId:new Map([...i.sourcesBySourceId].map(([e,t])=>[e,{...t,candidate:candidateFor(t.candidate)}])),subagentsBySourceId:new Map(o.subagents.map(e=>[e.candidate.sourceId,e]))}}function finalizeCandidateExternalDependencies(e,t){return e.backing.kind===`filesystem`?{...e,backing:finalizeBackingExternalDependencies(e.backing,t)}:e}function finalizeDescriptorExternalDependencies(e,t){return e.backing.kind===`filesystem`?{...e,backing:finalizeBackingExternalDependencies(e.backing,t)}:e}function finalizeBackingExternalDependencies(e,t){return{...e,externalDependencies:mergeExternalDependencies(t,e.externalDependencies)}}export{finalizeNodeSourceState};

package/dist/src/compiler/normalize-agent-config.d.ts

@@ -1,10 +1,14 @@
 import type { AgentSourceManifest } from "#discover/manifest.js";
+import type { ModuleSourceRef } from "#shared/source-ref.js";
 import type { CompiledAgentDefinition } from "#compiler/manifest.js";
 import { type ManifestCompileContext } from "#compiler/normalize-helpers.js";
+import type { CompiledModuleBinding } from "#compiler/source-graph.js";
 /**
  * Compiles the agent-level configuration (model, compaction, build,
  * workspace) for one authored agent node.
  */
-export declare function compileAgentConfig(manifest: AgentSourceManifest, context: ManifestCompileContext, options?: {
+export declare function compileAgentConfig(manifest: AgentSourceManifest, context: ManifestCompileContext, options: {
+    readonly binding: CompiledModuleBinding;
     readonly definition?: unknown;
+    readonly source: ModuleSourceRef;
 }): Promise<CompiledAgentDefinition>;

package/dist/src/compiler/normalize-agent-config.js

@@ -1 +1 @@
-import{isAbsolute,join,relative,resolve}from"node:path";import{DEFAULT_AGENT_MODEL_ID}from"#shared/default-agent-model.js";import{normalizeLogicalPath}from"#discover/filesystem.js";import{toErrorMessage}from"#shared/errors.js";import{serializeOutputSchema}from"#shared/tool-schema.js";import{classifyModelRouting}from"#internal/classify-model-routing.js";import{normalizeAgentDefinition}from"#internal/authored-definition/core.js";import{formatLanguageModelGatewayId}from"#internal/runtime-model.js";import{isChatGptModelRouting}from"#shared/chatgpt-model.js";import{parseJsonObject}from"#shared/json.js";import{isDynamicModelDefinition}from"#shared/agent-definition.js";import{loadModuleBackedDefinition}from"#compiler/normalize-helpers.js";async function compileAgentConfig(e,t,n={}){let r=e.configModule,a=r===void 0?void 0:formatAgentConfigModulePath(e,r),o=normalizeAgentDefinition(Object.hasOwn(n,`definition`)?n.definition:r===void 0?{model:DEFAULT_AGENT_MODEL_ID}:await loadModuleBackedDefinition({agentRoot:e.agentRoot,displayPath:a,kind:`agent config`,source:r}),r===void 0?`Expected the default agent config to match the public eve shape.`:`Expected the agent config export "${r.exportName??`default`}" from "${a}" to match the public eve shape.`),s=isDynamicModelDefinition(o.model)?o.model:void 0,c=s===void 0?await normalizeAuthoredModelReference({modelCatalog:t.modelCatalog,purpose:`the primary compaction trigger model`,contextWindowTokens:o.modelContextWindowTokens,providerOptions:o.modelOptions?.providerOptions,source:r,sourcePath:a,value:o.model}):void 0,l={},u={compaction:l,name:e.agentId};o.description!==void 0&&(u.description=o.description);let d;if(s!==void 0){if(r===void 0)throw Error(`Expected dynamic model definitions to be authored in agent.ts.`);d={eventNames:Object.keys(s.events),exportName:r.exportName,sourceKind:`module`,logicalPath:r.logicalPath,sourceId:r.sourceId}}let f=normalizeExperimentalDefinition(o.experimental);if(f!==void 0&&(u.experimental=f),o.build!==void 0&&(u.build={externalDependencies:o.build.externalDependencies===void 0?void 0:[...o.build.externalDependencies]}),o.outputSchema!==void 0&&(u.outputSchema=serializeOutputSchema(o.outputSchema)),o.reasoning!==void 0&&(u.reasoning=o.reasoning),o.limits!==void 0&&(u.limits={maxInputTokensPerSession:o.limits.maxInputTokensPerSession,maxOutputTokensPerSession:o.limits.maxOutputTokensPerSession,sessionTimeoutMs:o.limits.sessionTimeoutMs}),r!==void 0&&(u.source={exportName:r.exportName,sourceKind:`module`,logicalPath:r.logicalPath,sourceId:r.sourceId}),o.compaction?.model!==void 0&&(l.model=await normalizeAuthoredModelReference({modelCatalog:t.modelCatalog,purpose:`the compaction summary model`,contextWindowTokens:o.compaction.modelContextWindowTokens,providerOptions:o.modelOptions?.providerOptions,source:r,sourcePath:a,value:o.compaction.model})),o.compaction?.thresholdPercent!==void 0&&(l.thresholdPercent=o.compaction.thresholdPercent),d!==void 0)return{...u,dynamicModel:d};if(c===void 0)throw Error(`Expected a static agent model to compile to a concrete model reference.`);return{...u,model:c}}function normalizeExperimentalDefinition(e){if(e===void 0)return;let t={};return e.instrumentationProviders!==void 0&&(t.instrumentationProviders=e.instrumentationProviders),e.subagentPersistentSessions!==void 0&&(t.subagentPersistentSessions=e.subagentPersistentSessions),e.tasks!==void 0&&(t.tasks=e.tasks),e.workflow!==void 0&&(t.workflow={world:e.workflow.world}),t}async function normalizeAuthoredModelReference(e){if(typeof e.value==`string`)return await withCompiledRuntimeModelLimits({id:formatLanguageModelGatewayId(e.value),providerOptions:parseProviderOptionsRecord(e.providerOptions),routing:classifyModelRouting(e.value,e.providerOptions)},e);let t=e.source;if(t===void 0)throw Error(`Expected ${e.purpose} to provide a valid AI SDK language model reference.`);let n=e.value,r=n.specificationVersion;if(r!==`v2`&&r!==`v3`&&r!==`v4`||typeof n.provider!=`string`||typeof n.modelId!=`string`||typeof n.doGenerate!=`function`||typeof n.doStream!=`function`)throw Error(`Expected the authored agent config export "${t.exportName??`default`}" from "${e.sourcePath??t.logicalPath}" to provide a valid AI SDK language model.`);let i={id:formatLanguageModelGatewayId(n),source:{exportName:t.exportName,sourceKind:`module`,logicalPath:t.logicalPath,sourceId:t.sourceId},providerOptions:parseProviderOptionsRecord(e.providerOptions),routing:classifyModelRouting(n,e.providerOptions)};if(e.contextWindowTokens===void 0){if(isChatGptModelRouting(i.routing))return{...i,contextWindowTokens:2e5};try{let t=await e.modelCatalog.getByProviderModelId(n.provider,n.modelId);if(t)return{...i,id:t.slug,contextWindowTokens:t.limits.contextWindowTokens,maxOutputTokens:t.limits.maxOutputTokens}}catch{}}return await withCompiledRuntimeModelLimits(i,e)}function formatAgentConfigModulePath(e,r){let i=join(e.agentRoot,r.logicalPath);return normalizeLogicalPath(relative(resolveTopLevelAgentRoot(e),i))}function resolveTopLevelAgentRoot(e){let t=resolve(e.appRoot),n=resolve(t,`agent`);return isPathInsideOrEqual(n,resolve(e.agentRoot))?n:t}function isPathInsideOrEqual(t,r){let i=relative(t,r);return i===``||!i.startsWith(`..`)&&!isAbsolute(i)}async function withCompiledRuntimeModelLimits(e,t){if(t.contextWindowTokens!==void 0)return{...e,contextWindowTokens:t.contextWindowTokens};let n;try{n=await t.modelCatalog.getModelLimits(e.id)}catch(n){throw Error(`Failed to load AI Gateway model metadata for ${t.purpose} "${e.id}". ${toErrorMessage(n)}`)}if(n===null)throw Error(`Cannot compile agent compaction because ${t.purpose} "${e.id}" does not have known AI Gateway context window metadata.`);return{...e,contextWindowTokens:n.contextWindowTokens,maxOutputTokens:n.maxOutputTokens}}function parseProviderOptionsRecord(e){if(e===void 0)return;let t={};for(let[n,r]of Object.entries(e))t[n]=parseJsonObject(r);return t}export{compileAgentConfig};
+import{isAbsolute,relative,resolve}from"node:path";import{createCompiledBindingNamespaceLoader}from"#compiler/load-binding-namespace.js";import{normalizeLogicalPath}from"#discover/filesystem.js";import{toErrorMessage}from"#shared/errors.js";import{serializeOutputSchema}from"#tools/schema.js";import{normalizeAgentDefinition}from"#internal/authored-definition/core.js";import{formatLanguageModelGatewayId}from"#internal/runtime-model.js";import{classifyModelRouting}from"#internal/classify-model-routing.js";import{isChatGptModelRouting}from"#shared/chatgpt-model.js";import{parseJsonObject}from"#shared/json.js";import{isDynamicModelDefinition}from"#shared/agent-definition.js";import{loadModuleBackedDefinition}from"#compiler/normalize-helpers.js";async function compileAgentConfig(e,t,n){let i=n.source,a=formatAgentConfigModulePath(e,i,n.binding),o=normalizeAgentDefinition(Object.hasOwn(n,`definition`)?n.definition:await loadModuleBackedDefinition({binding:n.binding,displayPath:a,kind:`agent config`,loadNamespace:createCompiledBindingNamespaceLoader({bindings:{[i.sourceId]:n.binding},registries:t.registries}),source:i}),`Expected the agent config export "${i.exportName??`default`}" from "${a}" to match the public eve shape.`),s=isDynamicModelDefinition(o.model)?o.model:void 0,c=s===void 0?await normalizeAuthoredModelReference({modelCatalog:t.modelCatalog,purpose:`the primary compaction trigger model`,contextWindowTokens:o.modelContextWindowTokens,providerOptions:o.modelOptions?.providerOptions,source:i,sourcePath:a,value:o.model}):void 0,l={},u={compaction:l,name:e.agentId,source:{...i}};o.description!==void 0&&(u.description=o.description);let d;s!==void 0&&(d={eventNames:Object.keys(s.events),exportName:i.exportName,sourceKind:`module`,logicalPath:i.logicalPath,sourceId:i.sourceId});let f=normalizeExperimentalDefinition(o.experimental);if(f!==void 0&&(u.experimental=f),o.build!==void 0&&(u.build={externalDependencies:o.build.externalDependencies===void 0?void 0:[...o.build.externalDependencies]}),o.outputSchema!==void 0&&(u.outputSchema=serializeOutputSchema(o.outputSchema)),o.reasoning!==void 0&&(u.reasoning=o.reasoning),o.limits!==void 0&&(u.limits={maxInputTokensPerSession:o.limits.maxInputTokensPerSession,maxOutputTokensPerSession:o.limits.maxOutputTokensPerSession,sessionTimeoutMs:o.limits.sessionTimeoutMs}),o.compaction?.model!==void 0&&(l.model=await normalizeAuthoredModelReference({modelCatalog:t.modelCatalog,purpose:`the compaction summary model`,contextWindowTokens:o.compaction.modelContextWindowTokens,providerOptions:o.modelOptions?.providerOptions,source:i,sourcePath:a,value:o.compaction.model})),o.compaction?.thresholdPercent!==void 0&&(l.thresholdPercent=o.compaction.thresholdPercent),d!==void 0)return{...u,dynamicModel:d};if(c===void 0)throw Error(`Expected a static agent model to compile to a concrete model reference.`);return{...u,model:c}}function normalizeExperimentalDefinition(e){if(e===void 0)return;let t={};return e.instrumentationProviders!==void 0&&(t.instrumentationProviders=e.instrumentationProviders),e.tasks!==void 0&&(t.tasks=e.tasks),e.workflow!==void 0&&(t.workflow={world:e.workflow.world}),t}async function normalizeAuthoredModelReference(e){if(typeof e.value==`string`)return await withCompiledRuntimeModelLimits({id:formatLanguageModelGatewayId(e.value),providerOptions:parseProviderOptionsRecord(e.providerOptions),routing:classifyModelRouting(e.value,e.providerOptions)},e);let t=e.source;if(t===void 0)throw Error(`Expected ${e.purpose} to provide a valid AI SDK language model reference.`);let n=e.value,r=n.specificationVersion;if(r!==`v2`&&r!==`v3`&&r!==`v4`||typeof n.provider!=`string`||typeof n.modelId!=`string`||typeof n.doGenerate!=`function`||typeof n.doStream!=`function`)throw Error(`Expected the authored agent config export "${t.exportName??`default`}" from "${e.sourcePath??t.logicalPath}" to provide a valid AI SDK language model.`);let i={id:formatLanguageModelGatewayId(n),source:{exportName:t.exportName,sourceKind:`module`,logicalPath:t.logicalPath,sourceId:t.sourceId},providerOptions:parseProviderOptionsRecord(e.providerOptions),routing:classifyModelRouting(n,e.providerOptions)};if(e.contextWindowTokens===void 0){if(isChatGptModelRouting(i.routing))return{...i,contextWindowTokens:2e5};try{let t=await e.modelCatalog.getByProviderModelId(n.provider,n.modelId);if(t)return{...i,id:t.slug,contextWindowTokens:t.limits.contextWindowTokens,maxOutputTokens:t.limits.maxOutputTokens}}catch{}}return await withCompiledRuntimeModelLimits(i,e)}function formatAgentConfigModulePath(e,n,r){return r.backing.kind===`programmatic`?n.logicalPath:normalizeLogicalPath(relative(resolveTopLevelAgentRoot(e),r.backing.sourcePath))}function resolveTopLevelAgentRoot(e){let t=resolve(e.appRoot),r=resolve(t,`agent`);return isPathInsideOrEqual(r,resolve(e.agentRoot))?r:t}function isPathInsideOrEqual(n,r){let i=relative(n,r);return i===``||!i.startsWith(`..`)&&!isAbsolute(i)}async function withCompiledRuntimeModelLimits(e,t){if(t.contextWindowTokens!==void 0)return{...e,contextWindowTokens:t.contextWindowTokens};let n;try{n=await t.modelCatalog.getModelLimits(e.id)}catch(n){throw Error(`Failed to load AI Gateway model metadata for ${t.purpose} "${e.id}". ${toErrorMessage(n)}`)}if(n===null)throw Error(`Cannot compile agent compaction because ${t.purpose} "${e.id}" does not have known AI Gateway context window metadata.`);return{...e,contextWindowTokens:n.contextWindowTokens,maxOutputTokens:n.maxOutputTokens}}function parseProviderOptionsRecord(e){if(e===void 0)return;let t={};for(let[n,r]of Object.entries(e))t[n]=parseJsonObject(r);return t}export{compileAgentConfig};

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

@@ -1,5 +1,5 @@
 import type { ChannelSourceRef } from "#discover/manifest.js";
-import type { CompiledChannelEntry } from "#compiler/manifest.js";
+import type { CompiledChannelDefinition } from "#compiler/manifest.js";
 import { type ModuleBackedDefinitionLoadOptions } from "#compiler/normalize-helpers.js";
 /**
  * Compiles one authored channel module into the normalized channel
@@ -14,4 +14,10 @@ import { type ModuleBackedDefinitionLoadOptions } from "#compiler/normalize-help
  * a separate compiled channel entry. The channel name is derived from
  * the filesystem path; the URL path comes from the route's `path` field.
  */
-export declare function compileChannelDefinition(agentRoot: string, source: ChannelSourceRef, options?: ModuleBackedDefinitionLoadOptions): Promise<CompiledChannelEntry | readonly CompiledChannelEntry[]>;
+export declare function compileChannelDefinition(_agentRoot: string, source: ChannelSourceRef, options: ModuleBackedDefinitionLoadOptions): Promise<{
+    readonly kind: "disabled";
+    readonly name: string;
+} | {
+    readonly definitions: readonly CompiledChannelDefinition[];
+    readonly kind: "channel";
+}>;

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

@@ -1 +1 @@
-import{stripLogicalPathExtension}from"#discover/filesystem.js";import{loadModuleBackedDefinition}from"#compiler/normalize-helpers.js";import{normalizeChannelDefinition}from"#internal/authored-definition/channel.js";import{isDisabledRouteSentinel}from"#public/definitions/channel.js";async function compileChannelDefinition(n,r,i={}){let a=await loadModuleBackedDefinition({agentRoot:n,externalDependencies:i.externalDependencies,kind:`channel`,source:r}),o=stripLogicalPathExtension(r.logicalPath).replace(/^channels\//,``);if(isDisabledRouteSentinel(a))return{kind:`disabled`,name:o,logicalPath:r.logicalPath};let s=normalizeChannelDefinition(a,`Expected the channel export "${r.exportName??`default`}" from "${r.logicalPath}" to match the public eve shape.`);return s.routes.map(e=>({kind:`channel`,name:o,logicalPath:r.logicalPath,method:e.method.toUpperCase(),urlPath:e.path,sourceId:r.sourceId,sourceKind:`module`,exportName:r.exportName,adapterKind:extractAdapterKind(s.adapter),cors:s.cors}))}function extractAdapterKind(e){if(typeof e!=`object`||!e)return;let t=e.kind;return typeof t==`string`&&t.length>0?t:void 0}export{compileChannelDefinition};
+import{stripLogicalPathExtension}from"#discover/filesystem.js";import{loadModuleBackedDefinition}from"#compiler/normalize-helpers.js";import{normalizeChannelDefinition}from"#internal/authored-definition/channel.js";import{isDisabledRouteSentinel}from"#public/definitions/channel.js";async function compileChannelDefinition(n,r,i){let a=await loadModuleBackedDefinition({binding:i.binding,kind:`channel`,loadNamespace:i.loadNamespace,source:r}),o=stripLogicalPathExtension(r.logicalPath).replace(/^channels\//,``);if(isDisabledRouteSentinel(a))return{kind:`disabled`,name:o};let s=normalizeChannelDefinition(a,`Expected the channel export "${r.exportName??`default`}" from "${r.logicalPath}" to match the public eve shape.`);return{definitions:s.routes.map(e=>({kind:`channel`,name:o,logicalPath:r.logicalPath,method:e.method.toUpperCase(),urlPath:e.path,sourceId:r.sourceId,sourceKind:`module`,exportName:r.exportName,adapterKind:extractAdapterKind(s.adapter),cors:s.cors})),kind:`channel`}}function extractAdapterKind(e){if(typeof e!=`object`||!e)return;let t=e.kind;return typeof t==`string`&&t.length>0?t:void 0}export{compileChannelDefinition};

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

@@ -19,4 +19,4 @@ import { type ModuleBackedDefinitionLoadOptions } from "#compiler/normalize-help
  * of the connection pipeline (auth context, tool-result narrowing,
  * runtime resolution) stays protocol-agnostic.
  */
-export declare function compileConnectionDefinition(agentRoot: string, source: ConnectionSourceRef, options?: ModuleBackedDefinitionLoadOptions): Promise<CompiledConnectionDefinition>;
+export declare function compileConnectionDefinition(_agentRoot: string, source: ConnectionSourceRef, options: ModuleBackedDefinitionLoadOptions): Promise<CompiledConnectionDefinition>;

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

@@ -1 +1 @@
-import{loadModuleBackedDefinition}from"#compiler/normalize-helpers.js";import{normalizeMcpClientConnectionDefinition,normalizeOpenApiConnectionDefinition}from"#internal/authored-definition/connection.js";import{readConnectionProtocol}from"#public/definitions/connections/protocol.js";async function compileConnectionDefinition(r,i,a={}){let o=await loadModuleBackedDefinition({agentRoot:r,externalDependencies:a.externalDependencies,kind:`connection`,source:i}),s=readConnectionProtocol(o),c=`Expected the connection export "${i.exportName??`default`}" from "${i.logicalPath}" to match the public eve shape.`,l={connectionName:i.connectionName,exportName:i.exportName,logicalPath:i.logicalPath,sourceId:i.sourceId,sourceKind:`module`},u,d;if(s===`openapi`){let e=normalizeOpenApiConnectionDefinition(o,c);u={...l,description:e.description,protocol:`openapi`,url:e.baseUrl??``},d=e.auth}else{let e=normalizeMcpClientConnectionDefinition(o,c);u={...l,description:e.description,protocol:`mcp`,url:e.url},d=e.auth}let f=extractVercelConnectMarker(d);return f!==void 0&&(u.vercelConnect=f),u}function extractVercelConnectMarker(e){if(typeof e!=`object`||!e)return;let t=e.vercelConnect;if(typeof t!=`object`||!t)return;let n=t.connector;if(!(typeof n!=`string`||n.length===0))return{connector:n}}export{compileConnectionDefinition};
+import{loadModuleBackedDefinition}from"#compiler/normalize-helpers.js";import{normalizeMcpClientConnectionDefinition,normalizeOpenApiConnectionDefinition}from"#internal/authored-definition/connection.js";import{readConnectionProtocol}from"#public/definitions/connections/protocol.js";async function compileConnectionDefinition(r,i,a){let o=await loadModuleBackedDefinition({binding:a.binding,kind:`connection`,loadNamespace:a.loadNamespace,source:i}),s=readConnectionProtocol(o),c=`Expected the connection export "${i.exportName??`default`}" from "${i.logicalPath}" to match the public eve shape.`,l={connectionName:i.connectionName,exportName:i.exportName,logicalPath:i.logicalPath,sourceId:i.sourceId,sourceKind:`module`},u,d;if(s===`openapi`){let e=normalizeOpenApiConnectionDefinition(o,c);u={...l,description:e.description,protocol:`openapi`,url:e.baseUrl??``},d=e.auth}else{let e=normalizeMcpClientConnectionDefinition(o,c);u={...l,description:e.description,protocol:`mcp`,url:e.url},d=e.auth}let f=extractVercelConnectMarker(d);return f!==void 0&&(u.vercelConnect=f),u}function extractVercelConnectMarker(e){if(typeof e!=`object`||!e)return;let t=e.vercelConnect;if(typeof t!=`object`||!t)return;let n=t.connector;if(!(typeof n!=`string`||n.length===0))return{connector:n}}export{compileConnectionDefinition};

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

@@ -1,6 +1,7 @@
-import { type AuthoredModuleLoadOptions } from "#internal/authored-module-loader.js";
 import type { ModuleSourceRef } from "#shared/source-ref.js";
 import type { CompiledRuntimeModelCatalogLoader } from "#compiler/model-catalog.js";
+import { type AgentSourceRegistry, type CompiledModuleBinding, type AgentSourceOwner } from "#compiler/source-graph.js";
+import type { CompiledBindingNamespaceLoader } from "#compiler/load-binding-namespace.js";
 /**
  * Shared compile-time context threaded through every per-primitive
  * normalize step.
@@ -11,10 +12,18 @@ import type { CompiledRuntimeModelCatalogLoader } from "#compiler/model-catalog.
  */
 export interface ManifestCompileContext {
     readonly modelCatalog: CompiledRuntimeModelCatalogLoader;
+    readonly registries: readonly AgentSourceRegistry[];
 }
 export interface ModuleBackedDefinitionLoadOptions {
-    readonly externalDependencies?: AuthoredModuleLoadOptions["externalDependencies"];
+    readonly binding: CompiledModuleBinding;
+    readonly loadNamespace: CompiledBindingNamespaceLoader;
 }
+export interface SourceDefinitionCompileOptions {
+    readonly binding?: CompiledModuleBinding;
+    readonly loadNamespace?: CompiledBindingNamespaceLoader;
+    readonly owner: AgentSourceOwner;
+}
+export declare function requireModuleBackedDefinitionLoadOptions(options: SourceDefinitionCompileOptions, logicalPath: string): ModuleBackedDefinitionLoadOptions;
 /**
  * Loads one authored module's value for a given source reference and
  * resolves any value-returning factory it may export.
@@ -25,9 +34,9 @@ export interface ModuleBackedDefinitionLoadOptions {
  * authored file failed.
  */
 export declare function loadModuleBackedDefinition(input: {
-    readonly agentRoot: string;
+    readonly binding: CompiledModuleBinding;
     readonly displayPath?: string;
-    readonly externalDependencies?: ModuleBackedDefinitionLoadOptions["externalDependencies"];
     readonly kind: string;
+    readonly loadNamespace: CompiledBindingNamespaceLoader;
     readonly source: ModuleSourceRef;
 }): Promise<unknown>;

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

@@ -1 +1 @@
-import{getAuthoredModuleExport,materializeAuthoredModuleExport}from"#internal/authored-module.js";import{join}from"node:path";import{toErrorMessage}from"#shared/errors.js";import{loadAuthoredModuleNamespace}from"#internal/authored-module-loader.js";const SANDBOX_PARENT_DEFINITION_MARKER=Symbol.for(`eve.sandbox-parent-definition`);async function loadModuleBackedDefinition(t){let n=getAuthoredModuleExport(await loadAuthoredModuleNamespace(join(t.agentRoot,t.source.logicalPath),{externalDependencies:t.externalDependencies}),t.source);if(t.kind===`sandbox`&&typeof n==`function`&&Reflect.get(n,SANDBOX_PARENT_DEFINITION_MARKER)===!0)return n;try{return await materializeAuthoredModuleExport(n)}catch(e){throw t.kind===`sandbox`&&typeof n==`function`?Error(`Failed to execute the sandbox export "${t.source.exportName??`default`}" from "${t.displayPath??t.source.logicalPath}" as a zero-argument definition factory. Parent-sharing callbacks must be passed to defineSandbox(...): ${toErrorMessage(e)}`):Error(`Failed to execute the ${t.kind} export "${t.source.exportName??`default`}" from "${t.displayPath??t.source.logicalPath}": ${toErrorMessage(e)}`)}}export{loadModuleBackedDefinition};
+import{getAuthoredModuleExport,materializeAuthoredModuleExport}from"#internal/authored-module.js";import{toErrorMessage}from"#shared/errors.js";import"#compiler/source-graph.js";const SANDBOX_PARENT_DEFINITION_MARKER=Symbol.for(`eve.sandbox-parent-definition`);function requireModuleBackedDefinitionLoadOptions(e,t){if(e.binding===void 0||e.loadNamespace===void 0)throw Error(`Module-backed source "${t}" requires a compiled binding.`);return{binding:e.binding,loadNamespace:e.loadNamespace}}async function loadModuleBackedDefinition(n){if(n.binding.logicalPath!==n.source.logicalPath)throw Error(`Compiled binding "${n.source.sourceId}" targets "${n.binding.logicalPath}", not "${n.source.logicalPath}".`);let r=getAuthoredModuleExport(await n.loadNamespace(n.source.sourceId),n.source);if(n.kind===`sandbox`&&typeof r==`function`&&Reflect.get(r,SANDBOX_PARENT_DEFINITION_MARKER)===!0)return r;try{return await materializeAuthoredModuleExport(r)}catch(e){throw n.kind===`sandbox`&&typeof r==`function`?Error(`Failed to execute the sandbox export "${n.source.exportName??`default`}" from "${n.displayPath??n.source.logicalPath}" as a zero-argument definition factory. Parent-sharing callbacks must be passed to defineSandbox(...): ${toErrorMessage(e)}`):Error(`Failed to execute the ${n.kind} export "${n.source.exportName??`default`}" from "${n.displayPath??n.source.logicalPath}": ${toErrorMessage(e)}`)}}export{loadModuleBackedDefinition,requireModuleBackedDefinitionLoadOptions};

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

@@ -1,12 +1,5 @@
 import type { HookSourceRef } from "#discover/manifest.js";
-import type { CompiledHookDefinition } from "./manifest.js";
-/**
- * Compiles one authored hook module into the manifest entry stored on
- * the compiled agent node.
- *
- * Hook event handlers are arbitrary functions and cannot be statically
- * validated at compile time — the normalization step only derives the
- * path-relative slug used for diagnostics and ordering. Per-handler
- * validation lives in the runtime resolver.
- */
-export declare function compileHookEntry(source: HookSourceRef): CompiledHookDefinition;
+import type { CompiledHookDefinition } from "#compiler/manifest.js";
+import { type ModuleBackedDefinitionLoadOptions } from "#compiler/normalize-helpers.js";
+/** Compiles and validates one selected hook while preserving its exact subscriptions. */
+export declare function compileHookEntry(source: HookSourceRef, options: ModuleBackedDefinitionLoadOptions): Promise<CompiledHookDefinition>;

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

@@ -1 +1 @@
-import{stripLogicalPathExtension}from"../discover/filesystem.js";function compileHookEntry(e){return{exportName:e.exportName,logicalPath:e.logicalPath,slug:stripLogicalPathExtension(e.logicalPath).replace(/^hooks\//,``),sourceId:e.sourceId,sourceKind:`module`}}export{compileHookEntry};
+import{expectFunction,expectObjectRecord}from"#internal/authored-module.js";import{stripLogicalPathExtension}from"#discover/filesystem.js";import{loadModuleBackedDefinition}from"#compiler/normalize-helpers.js";async function compileHookEntry(n,r){let i=expectObjectRecord(await loadModuleBackedDefinition({binding:r.binding,kind:`hook`,loadNamespace:r.loadNamespace,source:n}),`Expected the hook export "${n.exportName??`default`}" from "${n.logicalPath}" to return an object.`),a=i.events===void 0?{}:expectObjectRecord(i.events,`Expected the hook export "${n.exportName??`default`}" from "${n.logicalPath}" to expose events as an object.`);return{eventNames:Object.entries(a).flatMap(([e,t])=>t===void 0?[]:(expectFunction(t,`Expected the hook export "${n.exportName??`default`}" from "${n.logicalPath}" to provide a function for events.${e}.`),[e])),exportName:n.exportName,logicalPath:n.logicalPath,slug:stripLogicalPathExtension(n.logicalPath).replace(/^hooks\//,``),sourceId:n.sourceId,sourceKind:`module`}}export{compileHookEntry};

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

@@ -1,6 +1,6 @@
 import type { InstructionsSourceRef } from "#discover/manifest.js";
 import type { CompiledDynamicInstructionsDefinition, CompiledInstructionsDefinition } from "#compiler/manifest.js";
-import { type ModuleBackedDefinitionLoadOptions } from "#compiler/normalize-helpers.js";
+import { type SourceDefinitionCompileOptions } from "#compiler/normalize-helpers.js";
 /**
  * Compiled instructions entry produced from one authored `instructions/*`
  * file or flat `instructions.{md,ts,...}`.
@@ -28,9 +28,9 @@ export type CompiledInstructionsEntry = {
  * classified and their event names recorded; the resolver runs at
  * runtime.
  */
-export declare function compileInstructionsEntry(agentRoot: string, source: InstructionsSourceRef, options?: ModuleBackedDefinitionLoadOptions): Promise<CompiledInstructionsEntry>;
+export declare function compileInstructionsEntry(_agentRoot: string, source: InstructionsSourceRef, options: SourceDefinitionCompileOptions): Promise<CompiledInstructionsEntry>;
 /**
  * @deprecated Use {@link compileInstructionsEntry} instead. Kept for
  * backwards compatibility with callers that pass a single source.
  */
-export declare function compileInstructions(agentRoot: string, source: InstructionsSourceRef, options?: ModuleBackedDefinitionLoadOptions): Promise<CompiledInstructionsDefinition>;
+export declare function compileInstructions(agentRoot: string, source: InstructionsSourceRef, options: SourceDefinitionCompileOptions): Promise<CompiledInstructionsDefinition>;

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

@@ -1 +1 @@
-import{stripLogicalPathExtension}from"#discover/filesystem.js";import{normalizeInstructionsDefinition}from"#internal/authored-definition/core.js";import{loadModuleBackedDefinition}from"#compiler/normalize-helpers.js";import{ALLOWED_DYNAMIC_INSTRUCTION_EVENTS,assertResolverOnlyDynamicSentinel,isDynamicSentinel}from"#shared/dynamic-tool-definition.js";async function compileInstructionsEntry(a,o,s={}){if(o.sourceKind===`markdown`){let n=normalizeInstructionsDefinition(o.definition,`Expected the compiled instructions definition at "${o.logicalPath}" to match the public eve shape.`);return{kind:`instructions`,definition:{name:stripLogicalPathExtension(o.logicalPath),logicalPath:o.logicalPath,content:n.content,role:n.role,sourceId:o.sourceId,sourceKind:o.sourceKind}}}let c=await loadModuleBackedDefinition({agentRoot:a,externalDependencies:s.externalDependencies,kind:`instructions`,source:o});if(isDynamicSentinel(c)){assertResolverOnlyDynamicSentinel(c,`Expected the instructions export "${o.exportName??`default`}" from "${o.logicalPath}" to match the public eve shape.`);let t=Object.keys(c.events),n=t.find(e=>!ALLOWED_DYNAMIC_INSTRUCTION_EVENTS.has(e));if(n!==void 0)throw Error(`Expected the instructions export "${o.exportName??`default`}" from "${o.logicalPath}" to use only "session.started" or "turn.started" events. Unsupported event: "${n}".`);let i=stripLogicalPathExtension(o.logicalPath).replace(/^instructions\//,``);return{kind:`dynamic-instructions`,definition:{eventNames:t,exportName:o.exportName,logicalPath:o.logicalPath,slug:i,sourceId:o.sourceId,sourceKind:`module`}}}let l=normalizeInstructionsDefinition(c,`Expected the instructions export "${o.exportName??`default`}" from "${o.logicalPath}" to match the public eve shape.`);return{kind:`instructions`,definition:{name:stripLogicalPathExtension(o.logicalPath),logicalPath:o.logicalPath,content:l.content,role:l.role,sourceId:o.sourceId,sourceKind:o.sourceKind}}}async function compileInstructions(e,t,n={}){let r=await compileInstructionsEntry(e,t,n);if(r.kind===`dynamic-instructions`)throw Error(`Expected static instructions from "${t.logicalPath}" but got a dynamic resolver. Use compileInstructionsEntry instead.`);return r.definition}export{compileInstructions,compileInstructionsEntry};
+import{stripLogicalPathExtension}from"#discover/filesystem.js";import{normalizeInstructionsDefinition}from"#internal/authored-definition/core.js";import{loadModuleBackedDefinition,requireModuleBackedDefinitionLoadOptions}from"#compiler/normalize-helpers.js";import{ALLOWED_DYNAMIC_INSTRUCTION_EVENTS,assertResolverOnlyDynamicSentinel,isDynamicSentinel}from"#dynamic/definition.js";async function compileInstructionsEntry(i,a,o){if(a.sourceKind===`markdown`){let n=normalizeInstructionsDefinition(a.definition,`Expected the compiled instructions definition at "${a.logicalPath}" to match the public eve shape.`);return{kind:`instructions`,definition:{name:stripLogicalPathExtension(a.logicalPath),logicalPath:a.logicalPath,owner:o.owner,content:n.content,role:n.role,sourceId:a.sourceId,sourceKind:a.sourceKind}}}let s=requireModuleBackedDefinitionLoadOptions(o,a.logicalPath),c=await loadModuleBackedDefinition({binding:s.binding,kind:`instructions`,loadNamespace:s.loadNamespace,source:a});if(isDynamicSentinel(c)){assertResolverOnlyDynamicSentinel(c,`Expected the instructions export "${a.exportName??`default`}" from "${a.logicalPath}" to match the public eve shape.`);let t=Object.keys(c.events),n=t.find(e=>!ALLOWED_DYNAMIC_INSTRUCTION_EVENTS.has(e));if(n!==void 0)throw Error(`Expected the instructions export "${a.exportName??`default`}" from "${a.logicalPath}" to use only "session.started" or "turn.started" events. Unsupported event: "${n}".`);let r=stripLogicalPathExtension(a.logicalPath).replace(/^instructions\//,``);return{kind:`dynamic-instructions`,definition:{eventNames:t,exportName:a.exportName,logicalPath:a.logicalPath,slug:r,sourceId:a.sourceId,sourceKind:`module`}}}let l=normalizeInstructionsDefinition(c,`Expected the instructions export "${a.exportName??`default`}" from "${a.logicalPath}" to match the public eve shape.`);return{kind:`instructions`,definition:{name:stripLogicalPathExtension(a.logicalPath),logicalPath:a.logicalPath,content:l.content,role:l.role,sourceId:a.sourceId,sourceKind:a.sourceKind}}}async function compileInstructions(e,t,n){let r=await compileInstructionsEntry(e,t,n);if(r.kind===`dynamic-instructions`)throw Error(`Expected static instructions from "${t.logicalPath}" but got a dynamic resolver. Use compileInstructionsEntry instead.`);return r.definition}export{compileInstructions,compileInstructionsEntry};

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

@@ -0,0 +1,29 @@
+import type { AgentSourceManifest, LocalSubagentSourceRef } from "#discover/manifest.js";
+import type { CompiledAgentDefinition, CompiledExtensionMount, CompiledRemoteAgentNode } from "#compiler/manifest.js";
+import type { ModuleSourceRef } from "#shared/source-ref.js";
+import { normalizeSubagentConfig } from "#compiler/normalize-subagent.js";
+import { type AgentModuleCandidate, type AgentSourceOwner, type AgentSourceRegistry, type ComposedAgentModuleCandidates, type CompiledModuleBinding } from "#compiler/source-graph.js";
+export declare function collectSelectedSourceIds(composed: ComposedAgentModuleCandidates): Set<string>;
+export declare function assertRootOnlyConfig(config: CompiledAgentDefinition, isRoot: boolean, agentId: string): void;
+export declare function assertApplicationOverlayCanApplyToAllNodes(logicalPaths: readonly string[]): void;
+export declare function assertUniqueRegistryIds(registries: readonly AgentSourceRegistry[]): void;
+export declare function assertRootOwnedSpecialTool(candidate: AgentModuleCandidate, label: string): void;
+export declare function assertNonExtensionSpecialTool(candidate: AgentModuleCandidate, label: string): void;
+export declare function withExtensionNamespace<T extends {
+    readonly extensionNamespace?: string;
+}>(definition: T, owner: AgentSourceOwner): T;
+export declare function assertUniqueBy<T>(values: readonly T[], identity: (value: T) => string, label: string): void;
+export declare function expectSubagentDescription(config: CompiledAgentDefinition, source: LocalSubagentSourceRef): string;
+export declare function createCompiledRemoteAgent(input: {
+    readonly binding: CompiledModuleBinding;
+    readonly definition: Extract<ReturnType<typeof normalizeSubagentConfig>, {
+        readonly kind: "remote";
+    }>;
+    readonly nodeId: string;
+    readonly owner: AgentSourceOwner;
+    readonly parentNodeId: string;
+    readonly source: LocalSubagentSourceRef;
+    readonly sourceRef: ModuleSourceRef;
+}): CompiledRemoteAgentNode;
+export declare function compileExtensionMounts(manifest: AgentSourceManifest, composed: ComposedAgentModuleCandidates): CompiledExtensionMount[];
+export declare function mergeExternalDependencies(...lists: ReadonlyArray<readonly string[] | undefined>): string[];

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

@@ -0,0 +1 @@
+import{posix}from"node:path";import{ROOT_COMPILED_AGENT_NODE_ID}from"#compiler/manifest.js";import{canonicalSourceSlot}from"#compiler/source-graph.js";import{mountRefNamespace,packageStateNamespace}from"#discover/extensions.js";import"#compiler/normalize-subagent.js";function collectSelectedSourceIds(e){return new Set([...e.selected.values()].map(e=>e.sourceId))}function assertRootOnlyConfig(e,t,n){if(!t){if(e.experimental?.workflow!==void 0)throw Error(`Workflow runtime configuration is only supported on the root agent config. Remove "experimental.workflow" from "${n}".`);if(e.experimental?.tasks!==void 0)throw Error(`Background tasks are only supported on the root agent config. Remove "experimental.tasks" from "${n}".`)}}function assertApplicationOverlayCanApplyToAllNodes(e){let t=e.find(e=>{let t=canonicalSourceSlot(e);return t===`agent`||t.startsWith(`channels/`)||t.startsWith(`schedules/`)||t.startsWith(`subagents/`)||t.startsWith(`extensions/`)});if(t!==void 0)throw Error(`Application programmatic source registered for all local nodes cannot declare "${t}".`)}function assertUniqueRegistryIds(e){let t=new Set;for(let n of e)for(let e of n.sources.keys()){if(t.has(e))throw Error(`Programmatic agent source id "${e}" is registered more than once.`);t.add(e)}}function assertRootOwnedSpecialTool(e,n){if(e.nodeId!==ROOT_COMPILED_AGENT_NODE_ID)throw Error(`${n} can only be enabled on the root agent.`);assertNonExtensionSpecialTool(e,n)}function assertNonExtensionSpecialTool(e,t){if(e.owner.kind===`extension`)throw Error(`${t} cannot be configured by an extension source.`)}function withExtensionNamespace(e,t){return t.kind===`extension`?{...e,extensionNamespace:t.namespace}:e}function assertUniqueBy(e,t,n){let r=new Set;for(let i of e){let e=t(i);if(r.has(e))throw Error(`Compiled ${n} "${e}" is declared more than once.`);r.add(e)}}function expectSubagentDescription(e,t){if(e.description===void 0||e.description.trim().length===0)throw Error(`Subagent "${t.logicalPath}" must define a non-empty description.`);return e.description}function createCompiledRemoteAgent(t){let n=t.source.logicalPath.endsWith(`.ts`)||t.source.logicalPath.endsWith(`.js`)?t.source.logicalPath:posix.join(t.source.logicalPath,`agent.ts`),r=t.source.sourceId,i={backing:t.binding.backing,logicalPath:n,owner:t.owner},a={backing:{kind:`resource`,sourcePath:t.source.entryPath},binding:i,description:t.definition.description,entryPath:t.source.entryPath,logicalPath:n,name:t.source.subagentId,nodeId:t.nodeId,owner:t.owner,parentNodeId:t.parentNodeId,path:t.definition.path,rootPath:t.source.rootPath,sourceId:r,sourceKind:`module`};return t.sourceRef.exportName!==void 0&&Object.assign(a,{exportName:t.sourceRef.exportName}),t.definition.outputSchema!==void 0&&Object.assign(a,{outputSchema:t.definition.outputSchema}),t.definition.url!==void 0&&Object.assign(a,{url:t.definition.url}),a}function compileExtensionMounts(e,t){let n=collectSelectedSourceIds(t);return e.resolvedExtensions.flatMap(t=>{let a=e.extensions.find(e=>mountRefNamespace(e.logicalPath)===t.namespace);return a===void 0||!n.has(a.sourceId)?[]:[{externalDependencies:[...t.externalDependencies],mountLogicalPath:a.logicalPath,mountSourceId:a.sourceId,namespace:t.namespace,packageName:t.packageName,packageNamespace:packageStateNamespace(t.packageName),sourceRoot:t.sourceRoot}]})}function mergeExternalDependencies(...e){return[...new Set(e.flatMap(e=>e??[]))]}export{assertApplicationOverlayCanApplyToAllNodes,assertNonExtensionSpecialTool,assertRootOnlyConfig,assertRootOwnedSpecialTool,assertUniqueBy,assertUniqueRegistryIds,collectSelectedSourceIds,compileExtensionMounts,createCompiledRemoteAgent,expectSubagentDescription,mergeExternalDependencies,withExtensionNamespace};

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

@@ -1,6 +1,10 @@
 import type { AgentSourceManifest } from "#discover/manifest.js";
 import { type CompiledAgentManifest } from "#compiler/manifest.js";
-/**
- * Compiles one discovery manifest into the normalized manifest loaded by the runtime.
- */
-export declare function compileAgentManifest(manifest: AgentSourceManifest): Promise<CompiledAgentManifest>;
+import { type CompilerDiagnostic } from "#compiler/diagnostics.js";
+import { type AgentSourceRegistry } from "#compiler/source-graph.js";
+export interface CompileAgentManifestOptions {
+    readonly diagnostics?: CompilerDiagnostic[];
+    readonly sourceRegistries?: readonly AgentSourceRegistry[];
+}
+/** Compiles one discovery graph through the canonical source composition pipeline. */
+export declare function compileAgentManifest(manifest: AgentSourceManifest, options?: CompileAgentManifestOptions): Promise<CompiledAgentManifest>;

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

@@ -1 +1 @@
-import{compileChannelDefinition}from"#compiler/normalize-channel.js";import{ROOT_COMPILED_AGENT_NODE_ID,createCompiledAgentManifest,createCompiledAgentNodeManifest,createCompiledAgentResources}from"#compiler/manifest.js";import{compileConnectionDefinition}from"#compiler/normalize-connection.js";import{compileHookEntry}from"#compiler/normalize-hook.js";import{compileInstructionsEntry}from"#compiler/normalize-instructions.js";import{compileScheduleDefinition}from"#compiler/normalize-schedule.js";import{compileSkillSource}from"#compiler/normalize-skill.js";import{compileToolEntry}from"#compiler/normalize-tool.js";import{mountRefNamespace,packageStateNamespace}from"#discover/extensions.js";import{createCompiledRuntimeModelCatalogLoader}from"#compiler/model-catalog.js";import{compileAgentConfig}from"#compiler/normalize-agent-config.js";import{compileExtensionContributions,composeAgentSubagentSources}from"#compiler/normalize-extension.js";import{compileSandboxDefinition}from"#compiler/normalize-sandbox.js";import{compileSubagentGraph}from"#compiler/normalize-subagent.js";async function compileAgentManifest(e){let r={modelCatalog:createCompiledRuntimeModelCatalogLoader(e.appRoot)},i=await compileAgentNodeManifest(e,r),a=await compileSubagentGraph({appRoot:e.appRoot,compileAgentNodeManifest,compileAgentResources,context:r,externalDependencies:i.config.build?.externalDependencies??[],parentAgentRoot:e.agentRoot,parentNodeId:ROOT_COMPILED_AGENT_NODE_ID,subagents:composeAgentSubagentSources(e)}),o=[i,...a.nodes.map(e=>e.agent)].flatMap(e=>e.tools).find(e=>e.execution===`background`);if(o!==void 0&&i.config.experimental?.tasks!==!0)throw Error(`Background tool "${o.name}" requires experimental.tasks: true in the root agent config.`);return createCompiledAgentManifest({...i,extensionMounts:i.extensionMounts,remoteAgents:a.remoteAgents,subagentEdges:a.edges,subagents:a.nodes})}async function compileAgentNodeManifest(e,t,n={}){let i=Object.hasOwn(n,`agentConfigDefinition`)?await compileAgentConfig(e,t,{definition:n.agentConfigDefinition}):await compileAgentConfig(e,t);if(n.allowRootOnlyConfig===!1&&i.experimental?.workflow!==void 0)throw Error(`Workflow runtime configuration is only supported on the root agent config. Remove "experimental.workflow" from "${e.agentId}".`);if(n.allowRootOnlyConfig===!1&&i.experimental?.tasks!==void 0)throw Error(`Background tasks are only supported on the root agent config. Remove "experimental.tasks" from "${e.agentId}".`);let a=mergeExternalDependencies(n.externalDependencies,i.build?.externalDependencies,e.resolvedExtensions.flatMap(e=>e.externalDependencies)),o=a.length===0?i:{...i,build:{...i.build,externalDependencies:a}};return createCompiledAgentNodeManifest({...await compileAgentResources(e,t,{externalDependencies:a}),config:o})}async function compileAgentResources(t,n,r={}){let s=[...r.externalDependencies??[]],c=await Promise.all(t.tools.map(e=>compileToolEntry(t.agentRoot,e,{externalDependencies:s}))),l=[],u=[],d=[],f,p;for(let e of c)e.kind===`tool`?l.push(e.definition):e.kind===`dynamic-tool`?u.push(e.definition):e.kind===`workflow-tool`?f={maxSubagents:e.maxSubagents}:e.kind===`web-search-tool`?p=e.provider:d.push(e.name);let m=(await Promise.all(t.channels.map(n=>compileChannelDefinition(t.agentRoot,n,{externalDependencies:s})))).flat(),h=await Promise.all(t.skills.map(e=>compileSkillSource(t.agentRoot,e,{externalDependencies:s}))),g=[],_=[];for(let e of h)e.kind===`skill`?g.push(e.definition):_.push(e.definition);let v=await Promise.all(t.instructions.map(e=>compileInstructionsEntry(t.agentRoot,e,{externalDependencies:s}))),y=[],b=[];for(let e of v)e.kind===`instructions`?y.push(e.definition):b.push(e.definition);let x=await Promise.all(t.connections.map(e=>compileConnectionDefinition(t.agentRoot,e,{externalDependencies:s}))),S=t.hooks.map(e=>compileHookEntry(e)),C=await Promise.all(t.schedules.map(e=>compileScheduleDefinition(t.agentRoot,e,{externalDependencies:s}))),w=new Set(l.map(e=>e.name)),T=new Set(u.map(e=>e.slug)),E=new Set(x.map(e=>e.connectionName)),D=new Set(g.map(e=>e.name)),O=[];for(let e of[...t.resolvedExtensions].sort((e,t)=>e.namespace.localeCompare(t.namespace))){let r=await compileExtensionContributions({mount:e,context:n,consumerAgentRoot:t.agentRoot,externalDependencies:s});m.push(...r.channels);for(let e of r.tools)w.has(e.name)||(w.add(e.name),l.push(e));for(let e of r.dynamicTools)T.has(e.slug)||(T.add(e.slug),u.push(e));for(let e of r.connections)E.has(e.connectionName)||(E.add(e.connectionName),x.push(e));for(let e of r.skills)D.has(e.name)||(D.add(e.name),g.push(e));C.push(...r.schedules),S.push(...r.hooks),_.push(...r.dynamicSkills),b.push(...r.dynamicInstructions),O.push(...r.instructions)}let k=[...y,...O];return createCompiledAgentResources({agentRoot:t.agentRoot,appRoot:t.appRoot,channels:m,extensionMounts:compileExtensionMounts(t),connections:x,diagnosticsSummary:t.diagnosticsSummary,disabledFrameworkTools:d,workflowTool:f,webSearchProvider:p,dynamicSkills:_,dynamicTools:u,hooks:S,sandbox:t.sandbox===null?null:await compileSandboxDefinition(t.agentRoot,t.sandbox,{externalDependencies:s}),sandboxWorkspaces:t.sandboxWorkspaces.map(e=>({logicalPath:e.logicalPath,rootEntries:[...e.rootEntries],sourceId:e.sourceId,sourcePath:e.sourcePath})),schedules:C,dynamicInstructions:b,skills:g,instructions:k,tools:l})}function compileExtensionMounts(e){return e.resolvedExtensions.map(t=>{let n=e.extensions.find(e=>mountRefNamespace(e.logicalPath)===t.namespace);return{externalDependencies:[...t.externalDependencies],namespace:t.namespace,packageName:t.packageName,packageNamespace:packageStateNamespace(t.packageName),sourceRoot:t.sourceRoot,mountSourceId:n?.sourceId??`extensions/${t.namespace}`,mountLogicalPath:n?.logicalPath??`extensions/${t.namespace}`}})}function mergeExternalDependencies(...e){let t=new Set;for(let n of e)for(let e of n??[])t.add(e);return[...t]}export{compileAgentManifest};
+import{compileChannelDefinition}from"#compiler/normalize-channel.js";import{createCompiledBindingNamespaceLoader}from"#compiler/load-binding-namespace.js";import{ROOT_COMPILED_AGENT_NODE_ID,createCompiledAgentManifest,createCompiledAgentNodeManifest,createCompiledAgentResources,createCompiledSubagentNodeId}from"#compiler/manifest.js";import{summarizeCompilerDiagnostics}from"#compiler/diagnostics.js";import{composeAgentModuleCandidates,createCompiledModuleBinding,createProgrammaticModuleCandidates,describeAgentSourceCandidate,disableComposedCandidate}from"#compiler/source-graph.js";import{frameworkAgentSourceRegistry}from"#framework/sources/registry.js";import{assertApplicationOverlayCanApplyToAllNodes,assertNonExtensionSpecialTool,assertRootOnlyConfig,assertRootOwnedSpecialTool,assertUniqueBy,assertUniqueRegistryIds,collectSelectedSourceIds,compileExtensionMounts,createCompiledRemoteAgent,expectSubagentDescription,mergeExternalDependencies,withExtensionNamespace}from"#compiler/normalize-manifest-helpers.js";import{loadModuleBackedDefinition}from"#compiler/normalize-helpers.js";import{assertRemoteAgentDefinitionHasNoLocalPackageEntries,normalizeSubagentConfig}from"#compiler/normalize-subagent.js";import{createCompiledRuntimeModelCatalogLoader}from"#compiler/model-catalog.js";import{compileAgentConfig}from"#compiler/normalize-agent-config.js";import{compileConnectionDefinition}from"#compiler/normalize-connection.js";import{compileHookEntry}from"#compiler/normalize-hook.js";import{compileInstructionsEntry}from"#compiler/normalize-instructions.js";import{compileSandboxDefinition}from"#compiler/normalize-sandbox.js";import{compileScheduleDefinition}from"#compiler/normalize-schedule.js";import{compileSkillSource}from"#compiler/normalize-skill.js";import{compileToolEntry}from"#compiler/normalize-tool.js";import{createCompiledChannelRoutePlan}from"#compiler/channel-route-plan.js";import{finalizeNodeSourceState}from"#compiler/node-source-state.js";import{projectAgentSources,projectSelectedSources}from"#compiler/project-sources.js";async function compileAgentManifest(e,t={}){let i=[frameworkAgentSourceRegistry,...t.sourceRegistries??[]];assertUniqueRegistryIds(i);let a={modelCatalog:createCompiledRuntimeModelCatalogLoader(e.appRoot),registries:i},o=t.diagnostics??[],c=await new AgentGraphCompiler(a,i,o).compileStaticNode({inheritedExternalDependencies:[],isRoot:!0,layer:`application`,manifest:e,nodeId:ROOT_COMPILED_AGENT_NODE_ID,owner:{kind:`application`}}),l=[c.manifest,...c.descendants.map(e=>e.agent)].flatMap(e=>e.tools).find(e=>e.execution===`background`);if(l!==void 0&&c.manifest.config.experimental?.tasks!==!0)throw Error(`Background tool "${l.name}" requires experimental.tasks: true in the root agent config.`);let u=summarizeCompilerDiagnostics(o),d=c.descendants.map(e=>(e.configResolver,{...e,agent:{...e.agent,diagnosticsSummary:u}}));return createCompiledAgentManifest({...c.manifest,diagnosticsSummary:u,subagents:d})}var AgentGraphCompiler=class{context;registries;diagnostics;constructor(e,t,n){this.context=e,this.registries=t,this.diagnostics=n}async compileStaticNode(e){let t=await this.createPhaseOneNodeSourceState(e,e.inheritedExternalDependencies),n=await compileAgentConfig(e.manifest,this.context,{binding:t.selectedConfig.binding,definition:t.selectedConfig.definition,source:t.selectedConfig.source});assertRootOnlyConfig(n,e.isRoot,e.manifest.agentId);let r=mergeExternalDependencies(e.inheritedExternalDependencies,n.build?.externalDependencies,e.manifest.resolvedExtensions.flatMap(e=>e.externalDependencies));r.length>0&&(n={...n,build:{...n.build,externalDependencies:r}});let a=finalizeNodeSourceState(t,r);assertInstrumentationLayoutConfig(n,a);let o=await this.compileResources(e,a),s=await this.compileChildren(e,a,r),c=createCompiledAgentNodeManifest({...o,config:n,remoteAgents:s.remoteAgents});return{descendants:s.nodes,manifest:c}}async compileChildren(e,t,n){let r=[],s=[],c=collectSelectedSourceIds(t.composed),l=t.projected.subagents.filter(e=>c.has(e.candidate.sourceId));for(let t of l){let c=t.source,l=createCompiledSubagentNodeId(e.nodeId,c.sourceId),u={extensionScope:t.extensionScope??e.extensionScope,inheritedExternalDependencies:n,isRoot:!1,layer:t.candidate.layer,manifest:c.manifest,nodeId:l,owner:t.owner,parentNodeId:e.nodeId},d=await this.createPhaseOneNodeSourceState(u,n),f=normalizeSubagentConfig(d.selectedConfig.definition,`Expected the subagent config export "${d.selectedConfig.source.exportName??`default`}" from "${c.entryPath}" to match the public eve shape.`);if(f.kind===`remote`){assertRemoteAgentDefinitionHasNoLocalPackageEntries(c),s.push(createCompiledRemoteAgent({binding:d.selectedConfig.binding,definition:f,nodeId:l,owner:t.owner,parentNodeId:e.nodeId,source:c,sourceRef:d.selectedConfig.source}));continue}let p,m;f.kind===`local`?(p=await compileAgentConfig(c.manifest,this.context,{binding:d.selectedConfig.binding,definition:f.definition,source:d.selectedConfig.source}),assertRootOnlyConfig(p,!1,c.manifest.agentId)):m=f.build?.externalDependencies;let h=mergeExternalDependencies(n,p?.build?.externalDependencies,m,c.manifest.resolvedExtensions.flatMap(e=>e.externalDependencies));p!==void 0&&h.length>0&&(p={...p,build:{...p.build,externalDependencies:h}});let _=finalizeNodeSourceState(d,h);p!==void 0&&assertInstrumentationLayoutConfig(p,_);let v=await this.compileResources(u,_),y=await this.compileChildren(u,_,h),b={backing:t.candidate.backing,entryPath:c.entryPath,logicalPath:c.logicalPath,name:c.subagentId,nodeId:l,owner:t.owner,parentNodeId:e.nodeId,rootPath:c.rootPath,sourceId:c.sourceId,sourceKind:`module`},x;x=p===void 0?{...b,agent:createCompiledAgentResources({...v,remoteAgents:y.remoteAgents}),configResolver:{build:f.kind===`dynamic`?f.build:void 0,eventNames:f.kind===`dynamic`?f.eventNames:[],exportName:d.selectedConfig.source.exportName,logicalPath:d.selectedConfig.source.logicalPath,sourceId:d.selectedConfig.source.sourceId,sourceKind:`module`}}:{...b,agent:createCompiledAgentNodeManifest({...v,config:p,remoteAgents:y.remoteAgents}),description:expectSubagentDescription(p,c)},r.push(x,...y.nodes)}return{nodes:r,remoteAgents:s}}composeNodeSources(e,t){let n=projectAgentSources({externalDependencies:t,extensionScope:e.extensionScope,layer:e.layer,manifest:e.manifest,nodeId:e.nodeId,owner:e.owner}),r=[],i=[];for(let t of this.registries){let n=t===frameworkAgentSourceRegistry;for(let a of t.registrations){if(a.applyTo===`root`&&!e.isRoot)continue;!n&&a.applyTo===`all-local-nodes`&&assertApplicationOverlayCanApplyToAllNodes(a.source.modules.map(e=>e.logicalPath));let t=createProgrammaticModuleCandidates({layer:n?`framework-default`:`application`,nodeId:e.nodeId,owner:n?{feature:a.source.id,kind:`framework`}:{kind:`application`},registration:a});(n?r:i).push(...t)}}let a=[...r,...n.candidates,...i],o=composeAgentModuleCandidates(a),s=projectSelectedSources({candidates:o.selected.values(),resources:n.resources});return{composed:o,orderedCandidates:a,projected:n,sourcesBySourceId:new Map(s.map(e=>[e.candidate.sourceId,e])),subagentsBySourceId:new Map(n.subagents.map(e=>[e.candidate.sourceId,e]))}}async createPhaseOneNodeSourceState(e,t){let n=this.composeNodeSources(e,t);return{graph:n,selectedConfig:await this.loadSelectedConfig(n)}}async loadSelectedConfig(e){let n=e.composed.selected.get(`agent`);if(n===void 0||!isModuleCandidate(n))throw Error(`Every local agent node requires a selected module-backed agent.ts source.`);let r=createCompiledModuleBinding(n),i=e.sourcesBySourceId.get(n.sourceId);if(i?.source.sourceKind!==`module`)throw Error(`Selected agent config source "${n.sourceId}" was not projected.`);let a=i.source;return{binding:r,candidate:n,definition:await loadModuleBackedDefinition({binding:r,kind:`agent config`,loadNamespace:createCompiledBindingNamespaceLoader({bindings:{[n.sourceId]:r},registries:this.registries}),source:a}),source:a}}async compileResources(n,r){let i=[],o=[],c=[],l=[],u=[],p=[],m=[],g=[],y=[],S=[],C,w,T,E,D=collectSelectedSourceIds(r.composed),O=createCompiledBindingNamespaceLoader({bindings:r.bindings,registries:this.registries});for(let t of r.orderedCandidates){if(!D.has(t.sourceId))continue;let a=r.sourcesBySourceId.get(t.sourceId);if(a===void 0)continue;let s=r.bindings[t.sourceId],d={binding:s,loadNamespace:O,owner:t.owner};switch(a.kind){case`config`:case`extension`:break;case`channel`:{let i=await compileChannelDefinition(n.manifest.agentRoot,a.source,{binding:s,loadNamespace:O});i.kind===`disabled`?(r.composed=disableComposedCandidate({candidate:t,composed:r.composed}),delete r.bindings[t.sourceId],D.delete(t.sourceId)):S.push(...i.definitions);break}case`connection`:m.push(await compileConnectionDefinition(n.manifest.agentRoot,a.source,{binding:s,loadNamespace:O}));break;case`hook`:g.push(await compileHookEntry(a.source,{binding:s,loadNamespace:O}));break;case`instructions`:{let e=await compileInstructionsEntry(n.manifest.agentRoot,a.source,d);e.kind===`instructions`?u.push(e.definition):p.push(e.definition);break}case`instrumentation`:w=a.source;break;case`sandbox`:C=await compileSandboxDefinition(n.manifest.agentRoot,a.source,{binding:s,loadNamespace:O});break;case`schedule`:y.push(await compileScheduleDefinition(n.manifest.agentRoot,a.source,d));break;case`skill`:{let e=await compileSkillSource(n.manifest.agentRoot,a.source,d);e.kind===`skill`?c.push(e.definition):l.push(withExtensionNamespace(e.definition,t.owner));break}case`tool`:{let e=await compileToolEntry(n.manifest.agentRoot,a.source,{binding:s,loadNamespace:O});e.kind===`disabled`?(r.composed=disableComposedCandidate({candidate:t,composed:r.composed}),delete r.bindings[t.sourceId],D.delete(t.sourceId)):e.kind===`tool`?i.push(e.definition):e.kind===`dynamic-tool`?o.push(withExtensionNamespace(e.definition,t.owner)):e.kind===`workflow-tool`?(assertRootOwnedSpecialTool(t,`Workflow`),T={...a.source,maxSubagents:e.maxSubagents}):(assertNonExtensionSpecialTool(t,`Web search`),i.push(e.definition),E=e.provider);break}}}if(C===void 0)throw Error(`Agent node "${n.nodeId}" has no selected sandbox source.`);assertUniqueBy(i,e=>e.name,`tool name`),assertUniqueBy(o,e=>e.slug,`dynamic tool slug`),assertUniqueBy(m,e=>e.connectionName,`connection name`),assertUniqueBy(c,e=>e.name,`skill name`);let k=createCompiledChannelRoutePlan({bindings:r.bindings,channels:S,diagnostics:this.diagnostics,nodeId:n.nodeId,sources:Object.fromEntries(r.orderedCandidates.map(e=>[e.sourceId,describeAgentSourceCandidate(e)]))});return createCompiledAgentResources({agentRoot:n.manifest.agentRoot,appRoot:n.manifest.appRoot,bindings:r.bindings,channelRoutes:k,connections:m,diagnosticsSummary:summarizeCompilerDiagnostics(this.diagnostics),dynamicInstructions:p,dynamicSkills:l,dynamicTools:o,extensionMounts:compileExtensionMounts(n.manifest,r.composed),hooks:g,instructions:u,instrumentation:w,sandbox:C,sandboxWorkspaces:n.manifest.sandboxWorkspaces.map(e=>({logicalPath:e.logicalPath,rootEntries:[...e.rootEntries],sourceId:e.sourceId,sourcePath:e.sourcePath})),schedules:y,skills:c,sourceComposition:r.composed.composition,tools:i,webSearchProvider:E,workflowTool:T})}};function isModuleCandidate(e){return e.backing.kind!==`resource`}function assertInstrumentationLayoutConfig(e,t){if(e.experimental?.instrumentationProviders===!0&&t.composed.selected.has(`instrumentation`))throw Error(`A selected instrumentation.ts source cannot be used with experimental.instrumentationProviders. Move the declaration into the instrumentation/ provider directory.`)}export{compileAgentManifest};

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

@@ -5,5 +5,5 @@ import { type ModuleBackedDefinitionLoadOptions } from "#compiler/normalize-help
  * Compiles one authored sandbox module into the normalized sandbox
  * definition stored on the compiled agent manifest.
  */
-export declare function compileSandboxDefinition(agentRoot: string, source: SandboxSourceRef, options?: ModuleBackedDefinitionLoadOptions): Promise<CompiledSandboxDefinition>;
+export declare function compileSandboxDefinition(_agentRoot: string, source: SandboxSourceRef, options: ModuleBackedDefinitionLoadOptions): Promise<CompiledSandboxDefinition>;
 export declare function resolveParentSandboxSelector(value: unknown, message: string): Promise<boolean>;

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

@@ -1 +1 @@
-import{createHash}from"node:crypto";import{readFile}from"node:fs/promises";import{join}from"node:path";import{toErrorMessage}from"#shared/errors.js";import{loadModuleBackedDefinition}from"#compiler/normalize-helpers.js";import{normalizeSandboxDefinition}from"#internal/authored-definition/sandbox.js";async function compileSandboxDefinition(e,t,n={}){let r=`Expected the sandbox export "${t.exportName??`default`}" from "${t.logicalPath}" to match the public eve shape.`,o=await loadModuleBackedDefinition({agentRoot:e,externalDependencies:n.externalDependencies,kind:`sandbox`,source:t}),s=await resolveParentSandboxSelector(o,r),c=normalizeSandboxDefinition(s?{}:o,r),l=c.revalidationKey===void 0?void 0:await resolveSandboxRevalidationKey({message:r,revalidationKey:c.revalidationKey,source:t});return{backendName:resolveCompiledBackendName(c.backend),description:c.description,inheritsParent:s||void 0,exportName:t.exportName,logicalPath:t.logicalPath,revalidationKey:l,sourceHash:await resolveSandboxSourceHash(e,t),sourceId:t.sourceId,sourceKind:`module`}}const PARENT_SANDBOX_VALUE=Object.freeze({__eveSandboxParentValue:Symbol(`parent`)});async function resolveParentSandboxSelector(e,t){if(typeof e!=`function`)return!1;let n;try{n=await e({parent:{sandbox:PARENT_SANDBOX_VALUE}})}catch(e){throw Error(`${t} The callback passed to defineSandbox(...) threw while selecting parent.sandbox: ${toErrorMessage(e)}`)}if(n!==PARENT_SANDBOX_VALUE)throw Error(`${t} The callback passed to defineSandbox(...) must return parent.sandbox. Export a sandbox definition object for an independent sandbox.`);return!0}function resolveCompiledBackendName(e){if(e!==void 0)try{return e.name}catch{return}}async function resolveSandboxRevalidationKey(e){let t;try{t=await e.revalidationKey()}catch(t){throw Error(`${e.message} Failed to execute the "revalidationKey" function from "${e.source.logicalPath}": ${toErrorMessage(t)}`)}if(typeof t!=`string`)throw Error(`${e.message} The "revalidationKey" function must return a string.`);if(t.trim().length===0)throw Error(`${e.message} The "revalidationKey" function must return a non-empty string.`);return t}async function resolveSandboxSourceHash(r,i){let a=await readFile(join(r,i.logicalPath));return createHash(`sha256`).update(a).digest(`hex`)}export{compileSandboxDefinition,resolveParentSandboxSelector};
+import{createHash}from"node:crypto";import{readFile}from"node:fs/promises";import{toErrorMessage}from"#shared/errors.js";import{loadModuleBackedDefinition}from"#compiler/normalize-helpers.js";import{normalizeSandboxDefinition}from"#internal/authored-definition/sandbox.js";async function compileSandboxDefinition(e,t,n){let i=`Expected the sandbox export "${t.exportName??`default`}" from "${t.logicalPath}" to match the public eve shape.`,a=await loadModuleBackedDefinition({binding:n.binding,kind:`sandbox`,loadNamespace:n.loadNamespace,source:t}),o=await resolveParentSandboxSelector(a,i),s=normalizeSandboxDefinition(o?{}:a,i),c=s.revalidationKey===void 0?void 0:await resolveSandboxRevalidationKey({message:i,revalidationKey:s.revalidationKey,source:t});return{backendName:resolveCompiledBackendName(s.backend),description:s.description,inheritsParent:o||void 0,exportName:t.exportName,logicalPath:t.logicalPath,revalidationKey:c,sourceHash:await resolveSandboxSourceHash(n.binding),sourceId:t.sourceId,sourceKind:`module`}}const PARENT_SANDBOX_VALUE=Object.freeze({__eveSandboxParentValue:Symbol(`parent`)});async function resolveParentSandboxSelector(e,t){if(typeof e!=`function`)return!1;let r;try{r=await e({parent:{sandbox:PARENT_SANDBOX_VALUE}})}catch(e){throw Error(`${t} The callback passed to defineSandbox(...) threw while selecting parent.sandbox: ${toErrorMessage(e)}`)}if(r!==PARENT_SANDBOX_VALUE)throw Error(`${t} The callback passed to defineSandbox(...) must return parent.sandbox. Export a sandbox definition object for an independent sandbox.`);return!0}function resolveCompiledBackendName(e){if(e!==void 0)try{return e.name}catch{return}}async function resolveSandboxRevalidationKey(e){let t;try{t=await e.revalidationKey()}catch(t){throw Error(`${e.message} Failed to execute the "revalidationKey" function from "${e.source.logicalPath}": ${toErrorMessage(t)}`)}if(typeof t!=`string`)throw Error(`${e.message} The "revalidationKey" function must return a string.`);if(t.trim().length===0)throw Error(`${e.message} The "revalidationKey" function must return a non-empty string.`);return t}async function resolveSandboxSourceHash(n){if(n.backing.kind===`programmatic`)return createHash(`sha256`).update(n.backing.semanticRevision??n.backing.revision).digest(`hex`);let r=await readFile(n.backing.sourcePath);return createHash(`sha256`).update(r).digest(`hex`)}export{compileSandboxDefinition,resolveParentSandboxSelector};

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

@@ -1,6 +1,6 @@
 import type { ScheduleSourceRef } from "#discover/manifest.js";
 import type { CompiledScheduleDefinition } from "#compiler/manifest.js";
-import { type ModuleBackedDefinitionLoadOptions } from "#compiler/normalize-helpers.js";
+import { type SourceDefinitionCompileOptions } from "#compiler/normalize-helpers.js";
 /**
  * Compiles one authored schedule into the normalized shape consumed by
  * the runtime scheduler.
@@ -12,4 +12,4 @@ import { type ModuleBackedDefinitionLoadOptions } from "#compiler/normalize-help
  * path under `schedules/` minus the extension
  * (`schedules/billing/invoice-sweep.ts` → `"billing/invoice-sweep"`).
  */
-export declare function compileScheduleDefinition(agentRoot: string, source: ScheduleSourceRef, options?: ModuleBackedDefinitionLoadOptions): Promise<CompiledScheduleDefinition>;
+export declare function compileScheduleDefinition(_agentRoot: string, source: ScheduleSourceRef, options: SourceDefinitionCompileOptions): Promise<CompiledScheduleDefinition>;

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

@@ -1 +1 @@
-import{stripLogicalPathExtension}from"#discover/filesystem.js";import{normalizeScheduleDefinition}from"#internal/authored-definition/core.js";import{loadModuleBackedDefinition}from"#compiler/normalize-helpers.js";async function compileScheduleDefinition(e,n,r={}){let i=n.sourceKind===`markdown`?normalizeScheduleDefinition(n.definition,`Expected the compiled schedule definition at "${n.logicalPath}" to match the public eve shape.`):normalizeScheduleDefinition(await loadModuleBackedDefinition({agentRoot:e,externalDependencies:r.externalDependencies,kind:`schedule`,source:n}),`Expected the schedule export "${n.exportName??`default`}" from "${n.logicalPath}" to match the public eve shape.`),a={cron:i.cron,hasRun:i.run!==void 0,logicalPath:n.logicalPath,name:deriveScheduleName(n.logicalPath),sourceId:n.sourceId,sourceKind:n.sourceKind};return i.markdown===void 0?a:{...a,markdown:i.markdown.trim()}}function deriveScheduleName(t){return stripLogicalPathExtension(t).replace(/^schedules\//,``)}export{compileScheduleDefinition};
+import{stripLogicalPathExtension}from"#discover/filesystem.js";import{normalizeScheduleDefinition}from"#internal/authored-definition/core.js";import{loadModuleBackedDefinition,requireModuleBackedDefinitionLoadOptions}from"#compiler/normalize-helpers.js";async function compileScheduleDefinition(e,n,r){let i=n.sourceKind===`markdown`?normalizeScheduleDefinition(n.definition,`Expected the compiled schedule definition at "${n.logicalPath}" to match the public eve shape.`):normalizeScheduleDefinition(await loadModuleBackedDefinition({...requireModuleBackedDefinitionLoadOptions(r,n.logicalPath),kind:`schedule`,source:n}),`Expected the schedule export "${n.exportName??`default`}" from "${n.logicalPath}" to match the public eve shape.`),a={cron:i.cron,hasRun:i.run!==void 0,logicalPath:n.logicalPath,name:deriveScheduleName(n.logicalPath),sourceId:n.sourceId,sourceKind:n.sourceKind},o=i.markdown===void 0?a:{...a,markdown:i.markdown.trim()};return n.sourceKind===`module`?{...o,sourceKind:`module`}:{...o,owner:r.owner,sourceKind:`markdown`}}function deriveScheduleName(t){return stripLogicalPathExtension(t).replace(/^schedules\//,``)}export{compileScheduleDefinition};

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

@@ -1,6 +1,6 @@
 import type { SkillSourceRef } from "#discover/manifest.js";
 import type { CompiledDynamicSkillDefinition, CompiledSkillDefinition } from "#compiler/manifest.js";
-import { type ModuleBackedDefinitionLoadOptions } from "#compiler/normalize-helpers.js";
+import { type SourceDefinitionCompileOptions } from "#compiler/normalize-helpers.js";
 /**
  * Compiled skill entry produced from one authored `skills/*` file.
  *
@@ -19,4 +19,4 @@ export type CompiledSkillEntry = {
  * package directory) into the normalized shape stored on the compiled
  * agent manifest.
  */
-export declare function compileSkillSource(agentRoot: string, source: SkillSourceRef, options?: ModuleBackedDefinitionLoadOptions): Promise<CompiledSkillEntry>;
+export declare function compileSkillSource(_agentRoot: string, source: SkillSourceRef, options: SourceDefinitionCompileOptions): Promise<CompiledSkillEntry>;

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

@@ -1 +1 @@
-import{stripLogicalPathExtension}from"#discover/filesystem.js";import{normalizeSkillDefinition}from"#internal/authored-definition/core.js";import{loadModuleBackedDefinition}from"#compiler/normalize-helpers.js";import{assertResolverOnlyDynamicSentinel,isDynamicSentinel}from"#shared/dynamic-tool-definition.js";async function compileSkillSource(r,i,a={}){if(i.sourceKind===`skill-package`)return{kind:`skill`,definition:compileSkillPackageSource(i)};if(i.sourceKind===`markdown`){let n=normalizeSkillDefinition(i.definition,`Expected the compiled skill definition at "${i.logicalPath}" to match the public eve shape.`);return{kind:`skill`,definition:{description:n.description,files:n.files,license:n.license,logicalPath:i.logicalPath,markdown:n.markdown,metadata:n.metadata===void 0?void 0:{...n.metadata},name:stripLogicalPathExtension(i.logicalPath).replace(/^skills\//,``),sourceId:i.sourceId,sourceKind:i.sourceKind}}}let o=await loadModuleBackedDefinition({agentRoot:r,externalDependencies:a.externalDependencies,kind:`skill`,source:i});if(isDynamicSentinel(o)){assertResolverOnlyDynamicSentinel(o,`Expected the skill export "${i.exportName??`default`}" from "${i.logicalPath}" to match the public eve shape.`);let t=stripLogicalPathExtension(i.logicalPath).replace(/^skills\//,``);return{kind:`dynamic-skill`,definition:{eventNames:Object.keys(o.events),exportName:i.exportName,logicalPath:i.logicalPath,slug:t,sourceId:i.sourceId,sourceKind:`module`}}}let s=normalizeSkillDefinition(o,`Expected the skill export "${i.exportName??`default`}" from "${i.logicalPath}" to match the public eve shape.`);return{kind:`skill`,definition:{description:s.description,files:s.files,license:s.license,logicalPath:i.logicalPath,markdown:s.markdown,metadata:s.metadata===void 0?void 0:{...s.metadata},name:stripLogicalPathExtension(i.logicalPath).replace(/^skills\//,``),sourceId:i.sourceId,sourceKind:i.sourceKind}}}function compileSkillPackageSource(e){return{assetsPath:e.assetsPath,description:e.description,license:e.license,logicalPath:e.logicalPath,markdown:e.markdown,metadata:e.metadata===void 0?void 0:{...e.metadata},name:e.name,referencesPath:e.referencesPath,rootPath:e.rootPath,scriptsPath:e.scriptsPath,skillId:e.skillId,skillFilePath:e.skillFilePath,sourceId:e.sourceId,sourceKind:`skill-package`}}export{compileSkillSource};
+import{stripLogicalPathExtension}from"#discover/filesystem.js";import{normalizeSkillDefinition}from"#internal/authored-definition/core.js";import{loadModuleBackedDefinition,requireModuleBackedDefinitionLoadOptions}from"#compiler/normalize-helpers.js";import{assertResolverOnlyDynamicSentinel,isDynamicSentinel}from"#dynamic/definition.js";async function compileSkillSource(r,i,a){if(i.sourceKind===`skill-package`)return{kind:`skill`,definition:compileSkillPackageSource(i,a.owner)};if(i.sourceKind===`markdown`){let n=normalizeSkillDefinition(i.definition,`Expected the compiled skill definition at "${i.logicalPath}" to match the public eve shape.`);return{kind:`skill`,definition:{description:n.description,files:n.files,license:n.license,logicalPath:i.logicalPath,owner:a.owner,markdown:n.markdown,metadata:n.metadata===void 0?void 0:{...n.metadata},name:stripLogicalPathExtension(i.logicalPath).replace(/^skills\//,``),sourceId:i.sourceId,sourceKind:i.sourceKind}}}let o=requireModuleBackedDefinitionLoadOptions(a,i.logicalPath),s=await loadModuleBackedDefinition({binding:o.binding,kind:`skill`,loadNamespace:o.loadNamespace,source:i});if(isDynamicSentinel(s)){assertResolverOnlyDynamicSentinel(s,`Expected the skill export "${i.exportName??`default`}" from "${i.logicalPath}" to match the public eve shape.`);let t=stripLogicalPathExtension(i.logicalPath).replace(/^skills\//,``);return{kind:`dynamic-skill`,definition:{eventNames:Object.keys(s.events),exportName:i.exportName,logicalPath:i.logicalPath,slug:t,sourceId:i.sourceId,sourceKind:`module`}}}let c=normalizeSkillDefinition(s,`Expected the skill export "${i.exportName??`default`}" from "${i.logicalPath}" to match the public eve shape.`);return{kind:`skill`,definition:{description:c.description,files:c.files,license:c.license,logicalPath:i.logicalPath,markdown:c.markdown,metadata:c.metadata===void 0?void 0:{...c.metadata},name:stripLogicalPathExtension(i.logicalPath).replace(/^skills\//,``),sourceId:i.sourceId,sourceKind:i.sourceKind}}}function compileSkillPackageSource(e,t){return{assetsPath:e.assetsPath,description:e.description,license:e.license,logicalPath:e.logicalPath,owner:t,markdown:e.markdown,metadata:e.metadata===void 0?void 0:{...e.metadata},name:e.name,referencesPath:e.referencesPath,rootPath:e.rootPath,scriptsPath:e.scriptsPath,skillId:e.skillId,skillFilePath:e.skillFilePath,sourceId:e.sourceId,sourceKind:`skill-package`}}export{compileSkillSource};