@telorun/analyzer 0.4.0 → 0.5.0

package/README.md

@@ -1,7 +1,3 @@
----
-description: "Telo: YAML-driven execution engine for declarative backends with micro-kernel architecture and language-agnostic design"
----
-
 # ⚡ Telo
 
 Runtime for declarative backends.

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-export { HttpAdapter } from "./adapters/http-adapter.js";
-export { RegistryAdapter } from "./adapters/registry-adapter.js";
 export { AnalysisRegistry } from "./analysis-registry.js";
 export { StaticAnalyzer } from "./analyzer.js";
 export { Loader } from "./manifest-loader.js";
-export { MODULE_KINDS, isModuleKind } from "./module-kinds.js";
+export { isModuleKind, MODULE_KINDS } from "./module-kinds.js";
 export type { ModuleKind } from "./module-kinds.js";
+export { HttpSource } from "./sources/http-source.js";
+export { RegistrySource } from "./sources/registry-source.js";
 export { DEFAULT_MANIFEST_FILENAME, DiagnosticSeverity } from "./types.js";
-export type { AnalysisDiagnostic, AnalysisOptions, LoaderInitOptions, LoadOptions, ManifestAdapter, Position, PositionIndex, Range } from "./types.js";
+export type { AnalysisDiagnostic, AnalysisOptions, LoaderInitOptions, LoadOptions, ManifestSource, Position, PositionIndex, Range } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC/D,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC3E,YAAY,EACR,kBAAkB,EAClB,eAAe,EAAE,iBAAiB,EAAE,WAAW,EAAE,eAAe,EAChE,QAAQ,EACR,aAAa,EACb,KAAK,EACR,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC/D,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC3E,YAAY,EACR,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,QAAQ,EACR,aAAa,EACb,KAAK,EACR,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,7 +1,7 @@
-export { HttpAdapter } from "./adapters/http-adapter.js";
-export { RegistryAdapter } from "./adapters/registry-adapter.js";
 export { AnalysisRegistry } from "./analysis-registry.js";
 export { StaticAnalyzer } from "./analyzer.js";
 export { Loader } from "./manifest-loader.js";
-export { MODULE_KINDS, isModuleKind } from "./module-kinds.js";
+export { isModuleKind, MODULE_KINDS } from "./module-kinds.js";
+export { HttpSource } from "./sources/http-source.js";
+export { RegistrySource } from "./sources/registry-source.js";
 export { DEFAULT_MANIFEST_FILENAME, DiagnosticSeverity } from "./types.js";

package/dist/manifest-loader.d.ts

@@ -1,11 +1,11 @@
 import { type ResourceManifest } from "@telorun/sdk";
-import { type LoadOptions, type LoaderInitOptions, type ManifestAdapter } from "./types.js";
+import { type LoadOptions, type LoaderInitOptions, type ManifestSource } from "./types.js";
 export declare class Loader {
-    private static readonly moduleCache;
-    protected adapters: ManifestAdapter[];
+    private readonly moduleCache;
+    protected sources: ManifestSource[];
     private readonly celEnv;
-    constructor(extraAdaptersOrOptions?: ManifestAdapter[] | LoaderInitOptions);
-    register(adapter: ManifestAdapter): this;
+    constructor(extraSourcesOrOptions?: ManifestSource[] | LoaderInitOptions);
+    register(source: ManifestSource): this;
     private pick;
     resolveEntryPoint(url: string): Promise<string>;
     loadModule(url: string, options?: LoadOptions): Promise<ResourceManifest[]>;

package/dist/manifest-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest-loader.d.ts","sourceRoot":"","sources":["../src/manifest-loader.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAOtE,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EAGrB,MAAM,YAAY,CAAC;AASpB,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAG/B;IAEJ,SAAS,CAAC,QAAQ,EAAE,eAAe,EAAE,CAAC;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,sBAAsB,GAAE,eAAe,EAAE,GAAG,iBAAsB;IAmB9E,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAKxC,OAAO,CAAC,IAAI;IAMN,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK/C,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAqGnE,eAAe;YAoBf,eAAe;IAgEvB,iBAAiB,CACrB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,gBAAgB,EAAE,CAAC;QAC9B,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;KAClD,GAAG,IAAI,CAAC;IAiCH,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,GAC5C,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAsCrC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;CA2GnE"}
+{"version":3,"file":"manifest-loader.d.ts","sourceRoot":"","sources":["../src/manifest-loader.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAOtE,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EAGpB,MAAM,YAAY,CAAC;AASpB,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAGxB;IAEJ,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,qBAAqB,GAAE,cAAc,EAAE,GAAG,iBAAsB;IAmB5E,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAKtC,OAAO,CAAC,IAAI;IAMN,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK/C,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAqGnE,eAAe;YAoBf,eAAe;IAgEvB,iBAAiB,CACrB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,gBAAgB,EAAE,CAAC;QAC9B,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;KAClD,GAAG,IAAI,CAAC;IAiCH,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,GAC5C,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAsCrC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;CA2GnE"}

package/dist/manifest-loader.js

@@ -1,7 +1,7 @@
 import { isCompiledValue } from "@telorun/sdk";
 import { isMap, isPair, isScalar, isSeq, parseAllDocuments } from "yaml";
-import { HttpAdapter } from "./adapters/http-adapter.js";
-import { RegistryAdapter } from "./adapters/registry-adapter.js";
+import { HttpSource } from "./sources/http-source.js";
+import { RegistrySource } from "./sources/registry-source.js";
 import { buildCelEnvironment } from "./cel-environment.js";
 import { isModuleKind } from "./module-kinds.js";
 import { precompileDoc } from "./precompile.js";
@@ -13,34 +13,34 @@ const SYSTEM_KINDS = new Set([
     "Telo.Definition",
 ]);
 export class Loader {
-    static moduleCache = new Map();
-    adapters;
+    moduleCache = new Map();
+    sources;
     celEnv;
-    constructor(extraAdaptersOrOptions = []) {
-        const options = Array.isArray(extraAdaptersOrOptions)
-            ? { extraAdapters: extraAdaptersOrOptions }
-            : extraAdaptersOrOptions;
-        const includeHttpAdapter = options.includeHttpAdapter ?? true;
-        const includeRegistryAdapter = options.includeRegistryAdapter ?? true;
-        this.adapters = [];
-        if (includeHttpAdapter)
-            this.adapters.push(new HttpAdapter());
-        if (includeRegistryAdapter)
-            this.adapters.push(new RegistryAdapter(options.registryUrl));
-        if (options.extraAdapters?.length) {
-            this.adapters.unshift(...options.extraAdapters);
+    constructor(extraSourcesOrOptions = []) {
+        const options = Array.isArray(extraSourcesOrOptions)
+            ? { extraSources: extraSourcesOrOptions }
+            : extraSourcesOrOptions;
+        const includeHttpSource = options.includeHttpSource ?? true;
+        const includeRegistrySource = options.includeRegistrySource ?? true;
+        this.sources = [];
+        if (includeHttpSource)
+            this.sources.push(new HttpSource());
+        if (includeRegistrySource)
+            this.sources.push(new RegistrySource(options.registryUrl));
+        if (options.extraSources?.length) {
+            this.sources.unshift(...options.extraSources);
         }
         this.celEnv = buildCelEnvironment(options.celHandlers);
     }
-    register(adapter) {
-        this.adapters.unshift(adapter);
+    register(source) {
+        this.sources.unshift(source);
         return this;
     }
     pick(url) {
-        const a = this.adapters.find((a) => a.supports(url));
-        if (!a)
-            throw new Error(`No adapter found for: ${url}`);
-        return a;
+        const s = this.sources.find((s) => s.supports(url));
+        if (!s)
+            throw new Error(`No source found for: ${url}`);
+        return s;
     }
     async resolveEntryPoint(url) {
         const { source } = await this.pick(url).read(url);
@@ -49,7 +49,7 @@ export class Loader {
     async loadModule(url, options) {
         const { text, source } = await this.pick(url).read(url);
         const cacheKey = `${options?.compile ? "compiled" : "raw"}:${source}`;
-        const cached = Loader.moduleCache.get(cacheKey);
+        const cached = this.moduleCache.get(cacheKey);
         if (cached && cached.text === text) {
             return cloneManifestArray(cached.manifests);
         }
@@ -126,8 +126,8 @@ export class Loader {
             const includePatterns = moduleManifest.include;
             if (includePatterns?.length) {
                 hasIncludes = true;
-                const adapter = this.pick(source);
-                const includedFiles = await this.resolveIncludes(source, includePatterns, adapter);
+                const picked = this.pick(source);
+                const includedFiles = await this.resolveIncludes(source, includePatterns, picked);
                 for (const includedUrl of includedFiles) {
                     const partialManifests = await this.loadPartialFile(includedUrl, moduleName, options);
                     resolved.push(...partialManifests);
@@ -135,22 +135,22 @@ export class Loader {
             }
         }
         if (!hasIncludes) {
-            Loader.moduleCache.set(cacheKey, { text, manifests: resolved });
+            this.moduleCache.set(cacheKey, { text, manifests: resolved });
         }
         return cloneManifestArray(resolved);
     }
-    async resolveIncludes(ownerSource, patterns, adapter) {
+    async resolveIncludes(ownerSource, patterns, source) {
         const hasGlobs = patterns.some((p) => /[*?{}\[\]]/.test(p));
         if (hasGlobs) {
-            if (!adapter.expandGlob) {
-                throw new Error(`Include patterns in '${ownerSource}' contain globs but the adapter for this source ` +
+            if (!source.expandGlob) {
+                throw new Error(`Include patterns in '${ownerSource}' contain globs but the source for this URL ` +
                     `does not support glob expansion. Use explicit file paths instead of patterns like: ` +
                     patterns.filter((p) => /[*?{}\[\]]/.test(p)).join(", "));
             }
-            return adapter.expandGlob(ownerSource, patterns);
+            return source.expandGlob(ownerSource, patterns);
         }
         // Literal relative paths — deduplicate in case the same file appears under multiple patterns.
-        return [...new Set(patterns.map((p) => adapter.resolveRelative(ownerSource, p)))];
+        return [...new Set(patterns.map((p) => source.resolveRelative(ownerSource, p)))];
     }
     async loadPartialFile(url, ownerModuleName, options) {
         const { text, source } = await this.pick(url).read(url);
@@ -228,10 +228,10 @@ export class Loader {
             // Otherwise fall through to owner lookup — this is likely a partial file
         }
         // Find the owning telo.yaml via parent-directory traversal
-        const adapter = this.pick(fileUrl);
-        if (!adapter.resolveOwnerOf)
+        const source = this.pick(fileUrl);
+        if (!source.resolveOwnerOf)
             return null;
-        const ownerUrl = await adapter.resolveOwnerOf(fileUrl);
+        const ownerUrl = await source.resolveOwnerOf(fileUrl);
         if (!ownerUrl)
             return null;
         // Load the owner module (which will load included files via include expansion)

package/dist/{adapters/http-adapter.d.ts → sources/http-source.d.ts}

@@ -1,5 +1,5 @@
-import { type ManifestAdapter } from "../types.js";
-export declare class HttpAdapter implements ManifestAdapter {
+import { type ManifestSource } from "../types.js";
+export declare class HttpSource implements ManifestSource {
     supports(url: string): boolean;
     read(url: string): Promise<{
         text: string;
@@ -7,4 +7,4 @@ export declare class HttpAdapter implements ManifestAdapter {
     }>;
     resolveRelative(base: string, relative: string): string;
 }
-//# sourceMappingURL=http-adapter.d.ts.map
+//# sourceMappingURL=http-source.d.ts.map

package/dist/sources/http-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-source.d.ts","sourceRoot":"","sources":["../../src/sources/http-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7E,qBAAa,UAAW,YAAW,cAAc;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIxB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAWlE,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;CAIxD"}

package/dist/{adapters/http-adapter.js → sources/http-source.js}

@@ -1,5 +1,5 @@
 import { DEFAULT_MANIFEST_FILENAME } from "../types.js";
-export class HttpAdapter {
+export class HttpSource {
     supports(url) {
         return url.startsWith("http://") || url.startsWith("https://");
     }

package/dist/{adapters/registry-adapter.d.ts → sources/registry-source.d.ts}

@@ -1,5 +1,5 @@
-import { type ManifestAdapter } from "../types.js";
-export declare class RegistryAdapter implements ManifestAdapter {
+import { type ManifestSource } from "../types.js";
+export declare class RegistrySource implements ManifestSource {
     private registryUrl;
     constructor(registryUrl?: string);
     supports(url: string): boolean;
@@ -12,4 +12,4 @@ export declare class RegistryAdapter implements ManifestAdapter {
     private toRegistryUrl;
     private parseModuleRef;
 }
-//# sourceMappingURL=registry-adapter.d.ts.map
+//# sourceMappingURL=registry-source.d.ts.map

package/dist/sources/registry-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-source.d.ts","sourceRoot":"","sources":["../../src/sources/registry-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAI7E,qBAAa,cAAe,YAAW,cAAc;IACvC,OAAO,CAAC,WAAW;gBAAX,WAAW,SAAuB;IAEtD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAWxB,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAWxE,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAMvD,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,cAAc;CAmBvB"}

package/dist/{adapters/registry-adapter.js → sources/registry-source.js}

@@ -1,6 +1,6 @@
 import { DEFAULT_MANIFEST_FILENAME } from "../types.js";
 const DEFAULT_REGISTRY_URL = "https://registry.telo.run";
-export class RegistryAdapter {
+export class RegistrySource {
     registryUrl;
     constructor(registryUrl = DEFAULT_REGISTRY_URL) {
         this.registryUrl = registryUrl;

package/dist/types.d.ts

@@ -35,7 +35,7 @@ export interface AnalysisDiagnostic {
     /** Telo-specific extras such as { resource: { kind, name }, path } */
     data?: unknown;
 }
-export interface ManifestAdapter {
+export interface ManifestSource {
     supports(url: string): boolean;
     read(url: string): Promise<{
         text: string;
@@ -44,11 +44,11 @@ export interface ManifestAdapter {
     resolveRelative(base: string, relative: string): string;
     /** Expand glob patterns relative to a base source. Returns sources in the same
      *  format as read().source — suitable to pass back into read() / resolveRelative().
-     *  Optional — only filesystem-capable adapters implement this. */
+     *  Optional — only filesystem-capable sources implement this. */
     expandGlob?(base: string, patterns: string[]): Promise<string[]>;
     /** Walk parent directories from fileUrl looking for the nearest telo.yaml.
      *  Returns the source in the same format as read().source, or null if none found.
-     *  Optional — only filesystem-capable adapters implement this. */
+     *  Optional — only filesystem-capable sources implement this. */
     resolveOwnerOf?(fileUrl: string): Promise<string | null>;
 }
 export interface LoadOptions {
@@ -59,13 +59,13 @@ export interface LoadOptions {
     compile?: boolean;
 }
 export interface LoaderInitOptions {
-    /** Adapters inserted with highest priority before built-ins. */
-    extraAdapters?: ManifestAdapter[];
-    /** Include built-in HttpAdapter. Defaults to true. */
-    includeHttpAdapter?: boolean;
-    /** Include built-in RegistryAdapter. Defaults to true. */
-    includeRegistryAdapter?: boolean;
-    /** Base URL used by built-in RegistryAdapter when enabled. */
+    /** Sources inserted with highest priority before built-ins. */
+    extraSources?: ManifestSource[];
+    /** Include built-in HttpSource. Defaults to true. */
+    includeHttpSource?: boolean;
+    /** Include built-in RegistrySource. Defaults to true. */
+    includeRegistrySource?: boolean;
+    /** Base URL used by built-in RegistrySource when enabled. */
     registryUrl?: string;
     /** Handlers for CEL stdlib functions (e.g. `sha256`). Analyzer-only callers may
      *  omit this and get throwing stubs; runtime callers (kernel) must supply real impls. */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;qHACqH;AACrH,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC;AACX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE9F,gFAAgF;AAChF,eAAO,MAAM,yBAAyB,cAAc,CAAC;AAErD,MAAM,WAAW,QAAQ;IACvB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,QAAQ,CAAC;IAChB,GAAG,EAAE,QAAQ,CAAC;CACf;AAED;;oDAEoD;AACpD,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE/C;6EAC6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7D,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAExD;;sEAEkE;IAClE,UAAU,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEjE;;sEAEkE;IAClE,cAAc,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,WAAW;IAC1B;;;+EAG2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,aAAa,CAAC,EAAE,eAAe,EAAE,CAAC;IAClC,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,0DAA0D;IAC1D,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;6FACyF;IACzF,WAAW,CAAC,EAAE,OAAO,sBAAsB,EAAE,WAAW,CAAC;CAC1D;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;gEAKgE;AAChE,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,qBAAqB,EAAE,aAAa,CAAC;IACtD,WAAW,CAAC,EAAE,OAAO,0BAA0B,EAAE,kBAAkB,CAAC;CACrE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;qHACqH;AACrH,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC;AACX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE9F,gFAAgF;AAChF,eAAO,MAAM,yBAAyB,cAAc,CAAC;AAErD,MAAM,WAAW,QAAQ;IACvB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,QAAQ,CAAC;IAChB,GAAG,EAAE,QAAQ,CAAC;CACf;AAED;;oDAEoD;AACpD,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE/C;6EAC6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7D,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAExD;;qEAEiE;IACjE,UAAU,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEjE;;qEAEiE;IACjE,cAAc,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,WAAW;IAC1B;;;+EAG2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,YAAY,CAAC,EAAE,cAAc,EAAE,CAAC;IAChC,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,yDAAyD;IACzD,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;6FACyF;IACzF,WAAW,CAAC,EAAE,OAAO,sBAAsB,EAAE,WAAW,CAAC;CAC1D;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;gEAKgE;AAChE,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,qBAAqB,EAAE,aAAa,CAAC;IACtD,WAAW,CAAC,EAAE,OAAO,0BAA0B,EAAE,kBAAkB,CAAC;CACrE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telorun/analyzer",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Telo Analyzer - Static manifest validator for Telo manifests.",
   "keywords": [
     "telo",
@@ -41,7 +41,7 @@
     "ajv-formats": "^3.0.1",
     "jsonpath-plus": "^10.3.0",
     "yaml": "^2.8.3",
-    "@telorun/sdk": "0.5.0"
+    "@telorun/sdk": "0.6.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",

package/src/index.ts

@@ -1,14 +1,17 @@
-export { HttpAdapter } from "./adapters/http-adapter.js";
-export { RegistryAdapter } from "./adapters/registry-adapter.js";
 export { AnalysisRegistry } from "./analysis-registry.js";
 export { StaticAnalyzer } from "./analyzer.js";
 export { Loader } from "./manifest-loader.js";
-export { MODULE_KINDS, isModuleKind } from "./module-kinds.js";
+export { isModuleKind, MODULE_KINDS } from "./module-kinds.js";
 export type { ModuleKind } from "./module-kinds.js";
+export { HttpSource } from "./sources/http-source.js";
+export { RegistrySource } from "./sources/registry-source.js";
 export { DEFAULT_MANIFEST_FILENAME, DiagnosticSeverity } from "./types.js";
 export type {
     AnalysisDiagnostic,
-    AnalysisOptions, LoaderInitOptions, LoadOptions, ManifestAdapter,
+    AnalysisOptions,
+    LoaderInitOptions,
+    LoadOptions,
+    ManifestSource,
     Position,
     PositionIndex,
     Range

package/src/manifest-loader.ts

@@ -1,8 +1,8 @@
 import type { Environment } from "@marcbachmann/cel-js";
 import { isCompiledValue, type ResourceManifest } from "@telorun/sdk";
 import { isMap, isPair, isScalar, isSeq, parseAllDocuments, type Document } from "yaml";
-import { HttpAdapter } from "./adapters/http-adapter.js";
-import { RegistryAdapter } from "./adapters/registry-adapter.js";
+import { HttpSource } from "./sources/http-source.js";
+import { RegistrySource } from "./sources/registry-source.js";
 import { buildCelEnvironment } from "./cel-environment.js";
 import { isModuleKind } from "./module-kinds.js";
 import { precompileDoc } from "./precompile.js";
@@ -10,7 +10,7 @@ import {
   DEFAULT_MANIFEST_FILENAME,
   type LoadOptions,
   type LoaderInitOptions,
-  type ManifestAdapter,
+  type ManifestSource,
   type Position,
   type PositionIndex,
 } from "./types.js";
@@ -23,42 +23,42 @@ const SYSTEM_KINDS = new Set([
 ]);
 
 export class Loader {
-  private static readonly moduleCache = new Map<
+  private readonly moduleCache = new Map<
     string,
     { text: string; manifests: ResourceManifest[] }
   >();
 
-  protected adapters: ManifestAdapter[];
+  protected sources: ManifestSource[];
   private readonly celEnv: Environment;
 
-  constructor(extraAdaptersOrOptions: ManifestAdapter[] | LoaderInitOptions = []) {
-    const options: LoaderInitOptions = Array.isArray(extraAdaptersOrOptions)
-      ? { extraAdapters: extraAdaptersOrOptions }
-      : extraAdaptersOrOptions;
+  constructor(extraSourcesOrOptions: ManifestSource[] | LoaderInitOptions = []) {
+    const options: LoaderInitOptions = Array.isArray(extraSourcesOrOptions)
+      ? { extraSources: extraSourcesOrOptions }
+      : extraSourcesOrOptions;
 
-    const includeHttpAdapter = options.includeHttpAdapter ?? true;
-    const includeRegistryAdapter = options.includeRegistryAdapter ?? true;
+    const includeHttpSource = options.includeHttpSource ?? true;
+    const includeRegistrySource = options.includeRegistrySource ?? true;
 
-    this.adapters = [];
-    if (includeHttpAdapter) this.adapters.push(new HttpAdapter());
-    if (includeRegistryAdapter) this.adapters.push(new RegistryAdapter(options.registryUrl));
+    this.sources = [];
+    if (includeHttpSource) this.sources.push(new HttpSource());
+    if (includeRegistrySource) this.sources.push(new RegistrySource(options.registryUrl));
 
-    if (options.extraAdapters?.length) {
-      this.adapters.unshift(...options.extraAdapters);
+    if (options.extraSources?.length) {
+      this.sources.unshift(...options.extraSources);
     }
 
     this.celEnv = buildCelEnvironment(options.celHandlers);
   }
 
-  register(adapter: ManifestAdapter): this {
-    this.adapters.unshift(adapter);
+  register(source: ManifestSource): this {
+    this.sources.unshift(source);
     return this;
   }
 
-  private pick(url: string): ManifestAdapter {
-    const a = this.adapters.find((a) => a.supports(url));
-    if (!a) throw new Error(`No adapter found for: ${url}`);
-    return a;
+  private pick(url: string): ManifestSource {
+    const s = this.sources.find((s) => s.supports(url));
+    if (!s) throw new Error(`No source found for: ${url}`);
+    return s;
   }
 
   async resolveEntryPoint(url: string): Promise<string> {
@@ -69,7 +69,7 @@ export class Loader {
   async loadModule(url: string, options?: LoadOptions): Promise<ResourceManifest[]> {
     const { text, source } = await this.pick(url).read(url);
     const cacheKey = `${options?.compile ? "compiled" : "raw"}:${source}`;
-    const cached = Loader.moduleCache.get(cacheKey);
+    const cached = this.moduleCache.get(cacheKey);
     if (cached && cached.text === text) {
       return cloneManifestArray(cached.manifests);
     }
@@ -152,8 +152,8 @@ export class Loader {
       const includePatterns = (moduleManifest as any).include as string[] | undefined;
       if (includePatterns?.length) {
         hasIncludes = true;
-        const adapter = this.pick(source);
-        const includedFiles = await this.resolveIncludes(source, includePatterns, adapter);
+        const picked = this.pick(source);
+        const includedFiles = await this.resolveIncludes(source, includePatterns, picked);
         for (const includedUrl of includedFiles) {
           const partialManifests = await this.loadPartialFile(includedUrl, moduleName, options);
           resolved.push(...partialManifests);
@@ -162,7 +162,7 @@ export class Loader {
     }
 
     if (!hasIncludes) {
-      Loader.moduleCache.set(cacheKey, { text, manifests: resolved });
+      this.moduleCache.set(cacheKey, { text, manifests: resolved });
     }
     return cloneManifestArray(resolved);
   }
@@ -170,21 +170,21 @@ export class Loader {
   private async resolveIncludes(
     ownerSource: string,
     patterns: string[],
-    adapter: ManifestAdapter,
+    source: ManifestSource,
   ): Promise<string[]> {
     const hasGlobs = patterns.some((p) => /[*?{}\[\]]/.test(p));
     if (hasGlobs) {
-      if (!adapter.expandGlob) {
+      if (!source.expandGlob) {
         throw new Error(
-          `Include patterns in '${ownerSource}' contain globs but the adapter for this source ` +
+          `Include patterns in '${ownerSource}' contain globs but the source for this URL ` +
             `does not support glob expansion. Use explicit file paths instead of patterns like: ` +
             patterns.filter((p) => /[*?{}\[\]]/.test(p)).join(", "),
         );
       }
-      return adapter.expandGlob(ownerSource, patterns);
+      return source.expandGlob(ownerSource, patterns);
     }
     // Literal relative paths — deduplicate in case the same file appears under multiple patterns.
-    return [...new Set(patterns.map((p) => adapter.resolveRelative(ownerSource, p)))];
+    return [...new Set(patterns.map((p) => source.resolveRelative(ownerSource, p)))];
   }
 
   private async loadPartialFile(
@@ -280,9 +280,9 @@ export class Loader {
     }
 
     // Find the owning telo.yaml via parent-directory traversal
-    const adapter = this.pick(fileUrl);
-    if (!adapter.resolveOwnerOf) return null;
-    const ownerUrl = await adapter.resolveOwnerOf(fileUrl);
+    const source = this.pick(fileUrl);
+    if (!source.resolveOwnerOf) return null;
+    const ownerUrl = await source.resolveOwnerOf(fileUrl);
     if (!ownerUrl) return null;
 
     // Load the owner module (which will load included files via include expansion)

package/src/{adapters/http-adapter.ts → sources/http-source.ts}

@@ -1,6 +1,6 @@
-import { DEFAULT_MANIFEST_FILENAME, type ManifestAdapter } from "../types.js";
+import { DEFAULT_MANIFEST_FILENAME, type ManifestSource } from "../types.js";
 
-export class HttpAdapter implements ManifestAdapter {
+export class HttpSource implements ManifestSource {
   supports(url: string): boolean {
     return url.startsWith("http://") || url.startsWith("https://");
   }

package/src/{adapters/registry-adapter.ts → sources/registry-source.ts}

@@ -1,8 +1,8 @@
-import { DEFAULT_MANIFEST_FILENAME, type ManifestAdapter } from "../types.js";
+import { DEFAULT_MANIFEST_FILENAME, type ManifestSource } from "../types.js";
 
 const DEFAULT_REGISTRY_URL = "https://registry.telo.run";
 
-export class RegistryAdapter implements ManifestAdapter {
+export class RegistrySource implements ManifestSource {
   constructor(private registryUrl = DEFAULT_REGISTRY_URL) {}
 
   supports(url: string): boolean {

package/src/types.ts

@@ -41,19 +41,19 @@ export interface AnalysisDiagnostic {
   data?: unknown;
 }
 
-export interface ManifestAdapter {
+export interface ManifestSource {
   supports(url: string): boolean;
   read(url: string): Promise<{ text: string; source: string }>;
   resolveRelative(base: string, relative: string): string;
 
   /** Expand glob patterns relative to a base source. Returns sources in the same
    *  format as read().source — suitable to pass back into read() / resolveRelative().
-   *  Optional — only filesystem-capable adapters implement this. */
+   *  Optional — only filesystem-capable sources implement this. */
   expandGlob?(base: string, patterns: string[]): Promise<string[]>;
 
   /** Walk parent directories from fileUrl looking for the nearest telo.yaml.
    *  Returns the source in the same format as read().source, or null if none found.
-   *  Optional — only filesystem-capable adapters implement this. */
+   *  Optional — only filesystem-capable sources implement this. */
   resolveOwnerOf?(fileUrl: string): Promise<string | null>;
 }
 
@@ -66,13 +66,13 @@ export interface LoadOptions {
 }
 
 export interface LoaderInitOptions {
-  /** Adapters inserted with highest priority before built-ins. */
-  extraAdapters?: ManifestAdapter[];
-  /** Include built-in HttpAdapter. Defaults to true. */
-  includeHttpAdapter?: boolean;
-  /** Include built-in RegistryAdapter. Defaults to true. */
-  includeRegistryAdapter?: boolean;
-  /** Base URL used by built-in RegistryAdapter when enabled. */
+  /** Sources inserted with highest priority before built-ins. */
+  extraSources?: ManifestSource[];
+  /** Include built-in HttpSource. Defaults to true. */
+  includeHttpSource?: boolean;
+  /** Include built-in RegistrySource. Defaults to true. */
+  includeRegistrySource?: boolean;
+  /** Base URL used by built-in RegistrySource when enabled. */
   registryUrl?: string;
   /** Handlers for CEL stdlib functions (e.g. `sha256`). Analyzer-only callers may
    *  omit this and get throwing stubs; runtime callers (kernel) must supply real impls. */

package/dist/adapters/http-adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"http-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/http-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9E,qBAAa,WAAY,YAAW,eAAe;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIxB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAWlE,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;CAIxD"}

package/dist/adapters/registry-adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"registry-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/registry-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAI9E,qBAAa,eAAgB,YAAW,eAAe;IACzC,OAAO,CAAC,WAAW;gBAAX,WAAW,SAAuB;IAEtD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAWxB,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAWxE,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAMvD,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,cAAc;CAmBvB"}