@telorun/analyzer 0.1.1 → 0.1.2

package/dist/adapters/http-adapter.js

@@ -11,7 +11,7 @@ export class HttpAdapter {
         return { text: await response.text(), source: fetchUrl };
     }
     resolveRelative(base, relative) {
-        const baseWithSlash = base.endsWith("/") ? base : `${base}/`;
-        return new URL(relative, baseWithSlash).href;
+        const baseDir = base.endsWith("/") ? base : base.slice(0, base.lastIndexOf("/") + 1);
+        return new URL(relative, baseDir).href;
     }
 }

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

@@ -1,11 +1,15 @@
 import type { ManifestAdapter } from "../types.js";
 export declare class RegistryAdapter implements ManifestAdapter {
+    private registryUrl;
+    constructor(registryUrl?: string);
     supports(url: string): boolean;
     read(moduleRef: string): Promise<{
         text: string;
         source: string;
     }>;
     resolveRelative(base: string, relative: string): string;
+    private toRegistryModuleBase;
     private toRegistryUrl;
+    private parseModuleRef;
 }
 //# sourceMappingURL=registry-adapter.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"registry-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/registry-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAInD,qBAAa,eAAgB,YAAW,eAAe;IACrD,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;IAQvD,OAAO,CAAC,aAAa;CAOtB"}
+{"version":3,"file":"registry-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/registry-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAInD,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"}

package/dist/adapters/registry-adapter.js

@@ -1,5 +1,9 @@
-const REGISTRY_BASE = "https://registry.telo.run";
+const DEFAULT_REGISTRY_URL = "https://registry.telo.run";
 export class RegistryAdapter {
+    registryUrl;
+    constructor(registryUrl = DEFAULT_REGISTRY_URL) {
+        this.registryUrl = registryUrl;
+    }
     supports(url) {
         return (!url.startsWith("http://") &&
             !url.startsWith("https://") &&
@@ -17,17 +21,32 @@ export class RegistryAdapter {
         return { text: await response.text(), source: fetchUrl };
     }
     resolveRelative(base, relative) {
-        const baseUrl = this.supports(base)
-            ? this.toRegistryUrl(base).replace("/module.yaml", "")
-            : base;
+        const baseUrl = this.supports(base) ? this.toRegistryModuleBase(base) : base;
         const baseWithSlash = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
         return new URL(relative, baseWithSlash).href;
     }
+    toRegistryModuleBase(moduleRef) {
+        const parsed = this.parseModuleRef(moduleRef);
+        const normalizedBase = this.registryUrl.replace(/\/+$/, "");
+        return `${normalizedBase}/${parsed.modulePath}/${parsed.version}`;
+    }
     toRegistryUrl(moduleRef) {
+        return `${this.toRegistryModuleBase(moduleRef)}/module.yaml`;
+    }
+    parseModuleRef(moduleRef) {
         const atIdx = moduleRef.lastIndexOf("@");
+        if (atIdx <= 0 || atIdx === moduleRef.length - 1) {
+            throw new Error(`Invalid module reference '${moduleRef}', expected namespace/name@version`);
+        }
         const modulePath = moduleRef.slice(0, atIdx);
-        const version = moduleRef.slice(atIdx + 1);
-        const versionSegment = version.startsWith("v") ? version.substring(1) : version;
-        return `${REGISTRY_BASE}/${modulePath}/${versionSegment}/module.yaml`;
+        if (!modulePath.includes("/")) {
+            throw new Error(`Invalid module reference '${moduleRef}', expected namespace/name@version`);
+        }
+        const rawVersion = moduleRef.slice(atIdx + 1);
+        const version = rawVersion.startsWith("v") ? rawVersion.substring(1) : rawVersion;
+        if (!version) {
+            throw new Error(`Invalid module reference '${moduleRef}', expected namespace/name@version`);
+        }
+        return { modulePath, version };
     }
 }

package/dist/analysis-registry.d.ts

@@ -23,6 +23,8 @@ export declare class AnalysisRegistry {
      * controller registry) can iterate them without importing KERNEL_BUILTINS directly.
      */
     builtinDefinitions(): ResourceDefinition[];
+    resolveDefinition(kind: string): ResourceDefinition | undefined;
+    allKinds(): string[];
     /** @internal Bridge for StaticAnalyzer — do not use outside the analyzer package. */
     _context(): AnalysisContext;
 }

package/dist/analysis-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analysis-registry.d.ts","sourceRoot":"","sources":["../src/analysis-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAKzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4B;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAE/C,kBAAkB,CAAC,GAAG,EAAE,kBAAkB,GAAG,IAAI;IAIjD,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAIpE,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAIpE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI7C;;;OAGG;IACH,mBAAmB,CACjB,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,EAClC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GACnC,IAAI;IAcP;;;;OAIG;IACH,kBAAkB,IAAI,kBAAkB,EAAE;IAI1C,qFAAqF;IACrF,QAAQ,IAAI,eAAe;CAG5B"}
+{"version":3,"file":"analysis-registry.d.ts","sourceRoot":"","sources":["../src/analysis-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAKzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4B;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAE/C,kBAAkB,CAAC,GAAG,EAAE,kBAAkB,GAAG,IAAI;IAIjD,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAIpE,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAIpE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI7C;;;OAGG;IACH,mBAAmB,CACjB,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,EAClC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GACnC,IAAI;IAcP;;;;OAIG;IACH,kBAAkB,IAAI,kBAAkB,EAAE;IAI1C,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAM/D,QAAQ,IAAI,MAAM,EAAE;IAIpB,qFAAqF;IACrF,QAAQ,IAAI,eAAe;CAG5B"}

package/dist/analysis-registry.js

@@ -48,6 +48,14 @@ export class AnalysisRegistry {
     builtinDefinitions() {
         return KERNEL_BUILTINS;
     }
+    resolveDefinition(kind) {
+        const ctx = this._context();
+        const resolved = ctx.aliases?.resolveKind(kind);
+        return ctx.definitions?.resolve(kind) ?? (resolved ? ctx.definitions?.resolve(resolved) : undefined);
+    }
+    allKinds() {
+        return this._context().definitions?.kinds() ?? [];
+    }
     /** @internal Bridge for StaticAnalyzer — do not use outside the analyzer package. */
     _context() {
         return { aliases: this.aliases, definitions: this.defs };

package/dist/analyzer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../src/analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAsB,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAW1D,OAAO,EAAsB,KAAK,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AA+I/F,qBAAa,cAAc;IACzB,OAAO,CACL,SAAS,EAAE,gBAAgB,EAAE,EAC7B,OAAO,CAAC,EAAE,eAAe,EACzB,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,kBAAkB,EAAE;IA0MvB,aAAa,CACX,SAAS,EAAE,gBAAgB,EAAE,EAC7B,OAAO,CAAC,EAAE,eAAe,EACzB,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,kBAAkB,EAAE;IAMvB,SAAS,CAAC,SAAS,EAAE,gBAAgB,EAAE,EAAE,QAAQ,EAAE,gBAAgB,GAAG,gBAAgB,EAAE;IAKxF,OAAO,CACL,SAAS,EAAE,gBAAgB,EAAE,EAC7B,QAAQ,EAAE,gBAAgB,GACzB;QAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;CAiB5F"}
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../src/analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAsB,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAW1D,OAAO,EAAsB,KAAK,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AA0O/F,qBAAa,cAAc;IACzB,OAAO,CACL,SAAS,EAAE,gBAAgB,EAAE,EAC7B,OAAO,CAAC,EAAE,eAAe,EACzB,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,kBAAkB,EAAE;IA+OvB,aAAa,CACX,SAAS,EAAE,gBAAgB,EAAE,EAC7B,OAAO,CAAC,EAAE,eAAe,EACzB,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,kBAAkB,EAAE;IAMvB,SAAS,CAAC,SAAS,EAAE,gBAAgB,EAAE,EAAE,QAAQ,EAAE,gBAAgB,GAAG,gBAAgB,EAAE;IAKxF,OAAO,CACL,SAAS,EAAE,gBAAgB,EAAE,EAC7B,QAAQ,EAAE,gBAAgB,GACzB;QAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;CAiB5F"}

package/dist/analyzer.js

@@ -5,7 +5,7 @@ import { buildDependencyGraph, formatCycle } from "./dependency-graph.js";
 import { normalizeInlineResources } from "./normalize-inline-resources.js";
 import { celTypeSatisfiesJsonSchema, substituteCelFields, validateAgainstSchema, } from "./schema-compat.js";
 import { DiagnosticSeverity } from "./types.js";
-import { extractAccessChains, pathMatchesScope, validateChainAgainstSchema, } from "./validate-cel-context.js";
+import { extractAccessChains, getManifestItem, pathMatchesScope, resolveContextAnnotations, resolveTypeFieldToSchema, validateChainAgainstSchema, } from "./validate-cel-context.js";
 import { validateReferences } from "./validate-references.js";
 const TEMPLATE_REGEX = /\$\{\{\s*([^}]+?)\s*\}\}/g;
 function walkCelExpressions(value, path, cb) {
@@ -53,6 +53,81 @@ function extractContextsFromSchema(schema, path = "$") {
     }
     return results;
 }
+/**
+ * Build a `steps` context schema from `x-telo-step-context` annotation.
+ * Walks each step in the manifest array, resolves the invoked resource's outputType,
+ * and builds `steps.<name>.result` context entries.
+ */
+function buildStepContextSchema(manifest, defSchema, allManifests) {
+    const props = defSchema.properties;
+    if (!props)
+        return undefined;
+    for (const [fieldName, fieldSchema] of Object.entries(props)) {
+        const stepCtx = fieldSchema["x-telo-step-context"];
+        if (!stepCtx)
+            continue;
+        const invokeField = stepCtx.invoke;
+        const outputTypeField = stepCtx.outputType;
+        if (!invokeField || !outputTypeField)
+            continue;
+        const steps = manifest[fieldName];
+        if (!Array.isArray(steps))
+            continue;
+        const stepProperties = {};
+        const collectSteps = (items) => {
+            for (const step of items) {
+                if (!step || typeof step !== "object")
+                    continue;
+                const s = step;
+                const name = s.name;
+                if (typeof name === "string") {
+                    const invoke = s[invokeField];
+                    let outputSchema;
+                    if (invoke && typeof invoke === "object") {
+                        const invokedKind = invoke.kind;
+                        const invokedName = invoke.name;
+                        if (invokedName) {
+                            const invokedManifest = allManifests.find((m) => m.metadata?.name === invokedName &&
+                                (!invokedKind || m.kind === invokedKind));
+                            if (invokedManifest) {
+                                outputSchema = resolveTypeFieldToSchema(invokedManifest[outputTypeField], allManifests);
+                            }
+                        }
+                        else {
+                            outputSchema = resolveTypeFieldToSchema(invoke[outputTypeField], allManifests);
+                        }
+                    }
+                    stepProperties[name] = {
+                        type: "object",
+                        properties: {
+                            result: outputSchema ?? { type: "object", additionalProperties: true },
+                        },
+                    };
+                }
+                // Recurse into nested step arrays (then, else, do, catch, finally, try, default, cases)
+                for (const nested of ["then", "else", "do", "catch", "finally", "try", "default"]) {
+                    if (Array.isArray(s[nested]))
+                        collectSteps(s[nested]);
+                }
+                // cases is an object map of arrays
+                if (s.cases && typeof s.cases === "object") {
+                    for (const arr of Object.values(s.cases)) {
+                        if (Array.isArray(arr))
+                            collectSteps(arr);
+                    }
+                }
+            }
+        };
+        collectSteps(steps);
+        if (Object.keys(stepProperties).length > 0) {
+            return {
+                type: "object",
+                properties: stepProperties,
+            };
+        }
+    }
+    return undefined;
+}
 const CEL_PURE_RE = /^\s*\$\{\{[^}]*\}\}\s*$/;
 const CEL_EXPR_RE = /\$\{\{\s*([^}]+?)\s*\}\}/;
 /** Recursively walk `data`+`schema` together, type-checking every pure CEL template
@@ -239,6 +314,10 @@ export class StaticAnalyzer {
             const resource = { kind: m.kind, name: m.metadata?.name };
             const resolvedKind = aliases.resolveKind(m.kind);
             const mDefinition = defs.resolve(m.kind) ?? (resolvedKind ? defs.resolve(resolvedKind) : undefined);
+            // Pre-compute step context for manifests with x-telo-step-context
+            const stepContextSchema = mDefinition?.schema
+                ? buildStepContextSchema(m, mDefinition.schema, allManifests)
+                : undefined;
             walkCelExpressions(m, "", (expr, path) => {
                 let parsed;
                 try {
@@ -254,23 +333,42 @@ export class StaticAnalyzer {
                     });
                     return;
                 }
+                const accessChains = extractAccessChains(parsed.ast);
                 const contexts = mDefinition?.schema ? extractContextsFromSchema(mDefinition.schema) : [];
                 const invocationContext = m.metadata?.xTeloInvocationContext;
-                if (contexts.length === 0 && !invocationContext)
+                // If no static context but we have step context, inject it
+                if (contexts.length === 0 && !invocationContext && !stepContextSchema)
                     return;
                 let matchedContext;
+                let matchedScope;
                 for (const ctx of contexts) {
                     if (pathMatchesScope(path, ctx.scope)) {
                         matchedContext = ctx.schema;
+                        matchedScope = ctx.scope;
                         break;
                     }
                 }
                 if (!matchedContext)
                     matchedContext = invocationContext;
+                // Merge step context into the effective context
+                if (stepContextSchema) {
+                    const base = matchedContext ?? { type: "object", properties: {}, additionalProperties: true };
+                    matchedContext = {
+                        ...base,
+                        properties: {
+                            ...(base.properties ?? {}),
+                            steps: stepContextSchema,
+                        },
+                    };
+                }
                 if (!matchedContext)
                     return;
-                for (const chain of extractAccessChains(parsed.ast)) {
-                    const err = validateChainAgainstSchema(chain, matchedContext);
+                const manifestItem = matchedScope
+                    ? getManifestItem(path, matchedScope, m)
+                    : m;
+                const effectiveContext = resolveContextAnnotations(matchedContext, manifestItem, allManifests);
+                for (const chain of accessChains) {
+                    const err = validateChainAgainstSchema(chain, effectiveContext);
                     if (!err)
                         continue;
                     diagnostics.push({

package/dist/index.d.ts

@@ -5,5 +5,5 @@ export { AnalysisRegistry } from "./analysis-registry.js";
 export { StaticAnalyzer } from "./analyzer.js";
 export { Loader } from "./manifest-loader.js";
 export { DiagnosticSeverity } from "./types.js";
-export type { AnalysisDiagnostic, AnalysisOptions, LoadOptions, ManifestAdapter, Position, PositionIndex, Range } from "./types.js";
+export type { AnalysisDiagnostic, AnalysisOptions, LoaderInitOptions, LoadOptions, ManifestAdapter, 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,iBAAiB,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC5E,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,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,YAAY,EACR,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,eAAe,EACf,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,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC5E,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,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,YAAY,EACR,kBAAkB,EAClB,eAAe,EAAE,iBAAiB,EAAE,WAAW,EAAE,eAAe,EAChE,QAAQ,EACR,aAAa,EACb,KAAK,EACR,MAAM,YAAY,CAAC"}

package/dist/manifest-loader.d.ts

@@ -1,11 +1,13 @@
 import type { ResourceManifest } from "@telorun/sdk";
-import type { LoadOptions, ManifestAdapter } from "./types.js";
+import type { LoadOptions, LoaderInitOptions, ManifestAdapter } from "./types.js";
 export declare class Loader {
     protected adapters: ManifestAdapter[];
-    constructor(extraAdapters?: ManifestAdapter[]);
+    constructor(extraAdaptersOrOptions?: ManifestAdapter[] | LoaderInitOptions);
     register(adapter: ManifestAdapter): this;
     private pick;
+    resolveEntryPoint(url: string): Promise<string>;
     loadModule(url: string, options?: LoadOptions): Promise<ResourceManifest[]>;
+    loadModuleGraph(entryUrl: string, onError?: (url: string, error: Error) => void): Promise<Map<string, ResourceManifest[]>>;
     loadManifests(entryUrl: string): Promise<ResourceManifest[]>;
 }
 //# sourceMappingURL=manifest-loader.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"manifest-loader.d.ts","sourceRoot":"","sources":["../src/manifest-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAKrD,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAA2B,MAAM,YAAY,CAAC;AAExF,qBAAa,MAAM;IACjB,SAAS,CAAC,QAAQ,EAAE,eAAe,EAAE,CAA8C;gBAEvE,aAAa,GAAE,eAAe,EAAO;IAIjD,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAKxC,OAAO,CAAC,IAAI;IAMN,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAgE3E,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAwCnE"}
+{"version":3,"file":"manifest-loader.d.ts","sourceRoot":"","sources":["../src/manifest-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAKrD,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,eAAe,EAGhB,MAAM,YAAY,CAAC;AAEpB,qBAAa,MAAM;IACjB,SAAS,CAAC,QAAQ,EAAE,eAAe,EAAE,CAAC;gBAE1B,sBAAsB,GAAE,eAAe,EAAE,GAAG,iBAAsB;IAiB9E,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;IAyE3E,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;CAoDnE"}

package/dist/manifest-loader.js

@@ -3,9 +3,21 @@ import { HttpAdapter } from "./adapters/http-adapter.js";
 import { RegistryAdapter } from "./adapters/registry-adapter.js";
 import { precompileDoc } from "./precompile.js";
 export class Loader {
-    adapters = [new HttpAdapter(), new RegistryAdapter()];
-    constructor(extraAdapters = []) {
-        this.adapters.unshift(...extraAdapters);
+    adapters;
+    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);
+        }
     }
     register(adapter) {
         this.adapters.unshift(adapter);
@@ -17,6 +29,10 @@ export class Loader {
             throw new Error(`No adapter found for: ${url}`);
         return a;
     }
+    async resolveEntryPoint(url) {
+        const { source } = await this.pick(url).read(url);
+        return source;
+    }
     async loadModule(url, options) {
         const { text, source } = await this.pick(url).read(url);
         const parsedDocuments = parseAllDocuments(text);
@@ -69,12 +85,58 @@ export class Loader {
         if (moduleName) {
             for (const manifest of resolved) {
                 if (manifest.kind !== "Kernel.Module" && !manifest.metadata?.module) {
+                    const pi = manifest.metadata?.positionIndex;
                     manifest.metadata = { ...manifest.metadata, module: moduleName };
+                    if (pi) {
+                        Object.defineProperty(manifest.metadata, "positionIndex", {
+                            value: pi,
+                            enumerable: false,
+                            writable: true,
+                            configurable: true,
+                        });
+                    }
                 }
             }
         }
         return resolved;
     }
+    async loadModuleGraph(entryUrl, onError) {
+        const visited = new Set([entryUrl]);
+        const result = new Map();
+        const entry = await this.loadModule(entryUrl);
+        result.set(entryUrl, entry);
+        const queue = [...entry];
+        while (queue.length > 0) {
+            const m = queue.shift();
+            if (m.kind !== "Kernel.Import")
+                continue;
+            const importSource = m.source;
+            if (!importSource)
+                continue;
+            const base = m.metadata?.source ?? entryUrl;
+            const importUrl = importSource.startsWith(".") || importSource.startsWith("/")
+                ? this.pick(base).resolveRelative(base, importSource)
+                : importSource;
+            if (visited.has(importUrl))
+                continue;
+            visited.add(importUrl);
+            let imported;
+            try {
+                imported = await this.loadModule(importUrl);
+            }
+            catch (err) {
+                const error = err instanceof Error ? err : new Error(String(err));
+                onError?.(importUrl, error);
+                continue;
+            }
+            result.set(importUrl, imported);
+            for (const im of imported) {
+                if (im.kind === "Kernel.Import")
+                    queue.push(im);
+            }
+        }
+        return result;
+    }
     async loadManifests(entryUrl) {
         const visited = new Set([entryUrl]);
         const entry = await this.loadModule(entryUrl);
@@ -88,7 +150,9 @@ export class Loader {
             if (!importSource)
                 continue;
             const base = m.metadata?.source ?? entryUrl;
-            const importUrl = this.pick(base).resolveRelative(base, importSource);
+            const importUrl = importSource.startsWith(".") || importSource.startsWith("/")
+                ? this.pick(base).resolveRelative(base, importSource)
+                : importSource;
             if (visited.has(importUrl))
                 continue;
             visited.add(importUrl);
@@ -103,11 +167,20 @@ export class Loader {
             }
             const importedModule = imported.find((im) => im.kind === "Kernel.Module");
             if (importedModule?.metadata?.name) {
+                const pi = m.metadata?.positionIndex;
                 m.metadata = {
                     ...m.metadata,
                     resolvedModuleName: importedModule.metadata.name,
                     resolvedNamespace: importedModule.metadata.namespace ?? null,
                 };
+                if (pi) {
+                    Object.defineProperty(m.metadata, "positionIndex", {
+                        value: pi,
+                        enumerable: false,
+                        writable: true,
+                        configurable: true,
+                    });
+                }
             }
             for (const im of imported) {
                 if (im.kind === "Kernel.Definition")

package/dist/schema-compat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-compat.d.ts","sourceRoot":"","sources":["../src/schema-compat.ts"],"names":[],"mappings":"AAGA,QAAA,MAAM,GAAG,KAA0C,CAAC;AAEpD;0FAC0F;AAC1F,wBAAgB,SAAS,IAAI,YAAY,CAAC,OAAO,GAAG,CAAC,CAMpD;AAID,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;oEAEoE;AACpE,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC1B,mBAAmB,CAIrB;AAiDD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAGlD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGxE;AAuBD,mFAAmF;AACnF,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;CACd;AAED,0GAA0G;AAC1G,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,WAAW,EAAE,CAY/F;AAED;qFACqF;AACrF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAQ7E;AAED;;;;6DAI6D;AAC7D,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,IAAI,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAsBjC;AAED,8DAA8D;AAC9D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,MAAM,CAgBnF;AAED,wFAAwF;AACxF,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC1B,OAAO,CAqBT;AAED,6EAA6E;AAC7E,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAW5E;AAID;iGACiG;AACjG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAqBvF"}
+{"version":3,"file":"schema-compat.d.ts","sourceRoot":"","sources":["../src/schema-compat.ts"],"names":[],"mappings":"AAGA,QAAA,MAAM,GAAG,KAA0C,CAAC;AAEpD;0FAC0F;AAC1F,wBAAgB,SAAS,IAAI,YAAY,CAAC,OAAO,GAAG,CAAC,CAMpD;AAID,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;oEAEoE;AACpE,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC1B,mBAAmB,CAIrB;AAiDD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAelD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGxE;AAuBD,mFAAmF;AACnF,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;CACd;AAED,0GAA0G;AAC1G,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,WAAW,EAAE,CAY/F;AAED;qFACqF;AACrF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAQ7E;AAED;;;;6DAI6D;AAC7D,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,IAAI,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAsBjC;AAED,8DAA8D;AAC9D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,MAAM,CAuBnF;AAED,wFAAwF;AACxF,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAqBhG;AAED,6EAA6E;AAC7E,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAiB5E;AAID;iGACiG;AACjG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAqBvF"}

package/dist/schema-compat.js

@@ -51,7 +51,19 @@ function checkProperty(source, target, path, issues) {
 }
 export function formatSingleError(err) {
     const p = err.instancePath || "/";
-    return `${p} ${err.message ?? "is invalid"}`;
+    const params = err.params ?? {};
+    switch (err.keyword) {
+        case "additionalProperties":
+            return `${p} must NOT have additional properties ('${params.additionalProperty}' is not allowed)`;
+        case "required":
+            return `${p} is missing required property '${params.missingProperty}'`;
+        case "enum":
+            return `${p} ${err.message ?? "is invalid"} (${params.allowedValues?.join(" | ")})`;
+        case "type":
+            return `${p} must be ${params.type} (got ${typeof err.data})`;
+        default:
+            return `${p} ${err.message ?? "is invalid"}`;
+    }
 }
 export function formatAjvErrors(errors) {
     if (!errors || errors.length === 0)
@@ -153,13 +165,20 @@ export function jsonSchemaToCelType(schema) {
     if (Array.isArray(schema.type))
         return "dyn";
     switch (schema.type) {
-        case "integer": return "int";
-        case "number": return "double";
-        case "string": return "string";
-        case "boolean": return "bool";
-        case "array": return "list";
-        case "object": return "map";
-        case "null": return "null_type";
+        case "integer":
+            return "int";
+        case "number":
+            return "double";
+        case "string":
+            return "string";
+        case "boolean":
+            return "bool";
+        case "array":
+            return "list";
+        case "object":
+            return "map";
+        case "null":
+            return "null_type";
     }
     if (schema.properties)
         return "map";
@@ -200,12 +219,18 @@ export function celPlaceholderForSchema(schema) {
         return schema.default;
     switch (schema.type) {
         case "integer":
-        case "number": return schema.minimum ?? 0;
-        case "string": return "";
-        case "boolean": return false;
-        case "array": return [];
-        case "object": return {};
-        default: return null;
+        case "number":
+            return schema.minimum ?? 0;
+        case "string":
+            return "";
+        case "boolean":
+            return false;
+        case "array":
+            return [];
+        case "object":
+            return {};
+        default:
+            return null;
     }
 }
 const CEL_PURE_RE = /^\s*\$\{\{[^}]*\}\}\s*$/;

package/dist/types.d.ts

@@ -48,6 +48,16 @@ export interface LoadOptions {
      *  the analyzer works on raw strings and does not need compiled values. */
     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. */
+    registryUrl?: string;
+}
 export interface AnalysisOptions {
     strictContexts?: boolean;
 }

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,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;CACzD;AAED,MAAM,WAAW,WAAW;IAC1B;;;+EAG2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;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,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;CACzD;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;CACtB;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/dist/validate-cel-context.d.ts

@@ -1,4 +1,11 @@
 import type { ASTNode } from "@marcbachmann/cel-js";
+/**
+ * Resolve a type field value (string name, inline type, or raw schema) to a JSON Schema.
+ * - String: look up the named type in allManifests (Type.JsonSchema resources)
+ * - Object with `kind` + `schema`: inline type definition → return the `schema`
+ * - Object with `type` or `properties`: raw JSON Schema, return as-is
+ */
+export declare function resolveTypeFieldToSchema(value: unknown, allManifests: Record<string, any>[]): Record<string, any> | undefined;
 /**
  * Extract all member-access chains from a CEL AST.
  * Returns arrays like ["request", "query", "name"] for `request.query.name`.
@@ -14,11 +21,26 @@ export declare function extractAccessChains(node: ASTNode): string[][];
  */
 export declare function validateChainAgainstSchema(chain: string[], schema: Record<string, any>): string | null;
 /**
- * Returns true when a CEL expression path (from walkCelExpressions, e.g. "routes[0].handler.inputs.name")
- * falls within the container region of a context scope (e.g. "$.routes[*].handler").
+ * Returns true when a CEL expression path (from walkCelExpressions, e.g. "routes[0].inputs.q")
+ * falls within the scope of a context (e.g. "$.routes[*].inputs").
  *
- * The container is derived by stripping the last dot-separated segment from the scope, so that
- * sibling fields within the same parent (e.g. routes[*].response) also match.
+ * The scope is matched directly (no sibling sharing): a context at "$.routes[*].inputs" only
+ * applies to expressions whose path starts with "routes[N].inputs", not to other sibling fields.
  */
 export declare function pathMatchesScope(exprPath: string, scope: string): boolean;
+/**
+ * Resolves `x-telo-context-from` annotations in a context schema using the concrete
+ * manifest item. Navigates the manifest item at the given slash-separated path and merges
+ * the result as named properties into the annotated node (locking additionalProperties: false).
+ *
+ * Example: `x-telo-context-from: "request/schema"` on the `request` context node replaces
+ * the open `request` schema with a closed schema whose properties are the keys of
+ * `manifestItem.request.schema` (e.g. `query`, `body`, `params`, `headers`).
+ */
+export declare function resolveContextAnnotations(schema: Record<string, any>, manifestItem: Record<string, any>, allManifests?: Record<string, any>[]): Record<string, any>;
+/**
+ * Extracts the concrete manifest array item for a given expression path + scope.
+ * e.g. exprPath="routes[0].inputs.q", scope="$.routes[*].inputs" → manifest.routes[0]
+ */
+export declare function getManifestItem(exprPath: string, scope: string, manifest: Record<string, any>): Record<string, any>;
 //# sourceMappingURL=validate-cel-context.d.ts.map

package/dist/validate-cel-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-cel-context.d.ts","sourceRoot":"","sources":["../src/validate-cel-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,EAAE,CAI7D;AAwED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC1B,MAAM,GAAG,IAAI,CAiBf;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAsBzE"}
+{"version":3,"file":"validate-cel-context.d.ts","sourceRoot":"","sources":["../src/validate-cel-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAClC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CA6BjC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,EAAE,CAI7D;AAwED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC1B,MAAM,GAAG,IAAI,CAmBf;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAoBzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GACnC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAqDrB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAQrB"}