veryfront 0.1.1237 → 0.1.1239

package/esm/src/extensions/builtin-extensions.d.ts

@@ -3,28 +3,23 @@ import type { EvalReportExporterRegistry } from "./eval/index.js";
 import type { LLMProviderRegistry } from "./llm/index.js";
 import { type FirstPartyEvalExporterSelection } from "./first-party-defaults.js";
 export { ensureBuiltinSchemaValidator } from "./builtin-schema-validator.js";
-export type OptionalBuiltinExtensionDefinition = {
+type DeferredBuiltinExtensionBase = {
     readonly name: string;
     readonly origin: string;
     readonly sourceDirectory: string;
     readonly evalExporterSelection?: FirstPartyEvalExporterSelection;
-    readonly factory?: ExtensionFactory;
 };
-export declare const OPTIONAL_BUILTIN_EXTENSIONS: readonly Readonly<{
-    factory?: ExtensionFactory | undefined;
-    evalExporterSelection?: Readonly<{
-        kind: "any-selected";
-    }> | Readonly<{
-        kind: "id";
-        id: "mlflow";
-    }> | undefined;
-    name: string;
-    origin: `veryfront/${string}`;
-    sourceDirectory: string;
-}>[];
+export type DeferredBuiltinExtensionDefinition = DeferredBuiltinExtensionBase & ({
+    readonly availability: "package";
+    readonly factory?: never;
+} | {
+    readonly availability: "root-bundled";
+    readonly factory: ExtensionFactory;
+});
+export declare const DEFERRED_BUILTIN_EXTENSIONS: readonly DeferredBuiltinExtensionDefinition[];
 export declare function ensureBuiltinEvalReportExporterRegistry(): EvalReportExporterRegistry;
 export declare function ensureBuiltinLLMProviders(): LLMProviderRegistry;
-export declare function createOptionalBuiltinExtension(definition: OptionalBuiltinExtensionDefinition): ResolvedExtension;
+export declare function createDeferredBuiltinExtension(definition: DeferredBuiltinExtensionDefinition): ResolvedExtension;
 export declare function createBuiltinExtensions(): ResolvedExtension[];
 export declare function createEvalCliBuiltinExtensions(selectedExporterIds?: string[]): ResolvedExtension[];
 //# sourceMappingURL=builtin-extensions.d.ts.map

package/esm/src/extensions/builtin-extensions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builtin-extensions.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/builtin-extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,gBAAgB,EAAmB,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAIlG,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAQlE,OAAO,KAAK,EAAe,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAEvE,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,2BAA2B,CAAC;AAMnC,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAQ7E,MAAM,MAAM,kCAAkC,GAAG;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,+BAA+B,CAAC;IACjE,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;CACrC,CAAC;AAoBF,eAAO,MAAM,2BAA2B;;;;;;;;;;;IAkBvC,CAAC;AAWF,wBAAgB,uCAAuC,IAAI,0BAA0B,CASpF;AAYD,wBAAgB,yBAAyB,IAAI,mBAAmB,CAQ/D;AA2CD,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,kCAAkC,GAC7C,iBAAiB,CAQnB;AA4ED,wBAAgB,uBAAuB,IAAI,iBAAiB,EAAE,CAa7D;AAED,wBAAgB,8BAA8B,CAC5C,mBAAmB,GAAE,MAAM,EAAO,GACjC,iBAAiB,EAAE,CAiBrB"}
+{"version":3,"file":"builtin-extensions.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/builtin-extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,gBAAgB,EAAmB,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAIlG,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAQlE,OAAO,KAAK,EAAe,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAEvE,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,2BAA2B,CAAC;AAMnC,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAQ7E,KAAK,4BAA4B,GAAG;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,+BAA+B,CAAC;CAClE,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAC1C,4BAA4B,GAC5B,CACE;IAAE,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,CAAA;CAAE,GAC9D;IAAE,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,CAChF,CAAC;AAoBJ,eAAO,MAAM,2BAA2B,+CAyBvC,CAAC;AAWF,wBAAgB,uCAAuC,IAAI,0BAA0B,CASpF;AAYD,wBAAgB,yBAAyB,IAAI,mBAAmB,CAQ/D;AA2CD,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,kCAAkC,GAC7C,iBAAiB,CAQnB;AA6ED,wBAAgB,uBAAuB,IAAI,iBAAiB,EAAE,CAa7D;AAED,wBAAgB,8BAA8B,CAC5C,mBAAmB,GAAE,MAAM,EAAO,GACjC,iBAAiB,EAAE,CAiBrB"}

package/esm/src/extensions/builtin-extensions.js

@@ -30,21 +30,26 @@ const BUILTIN_LLM_PROVIDERS = [
         provider: () => new GoogleProvider(),
     },
 ];
-export const OPTIONAL_BUILTIN_EXTENSIONS = Object.freeze(FIRST_PARTY_DEFERRED_BUILTIN_EXTENSION_POLICIES.map((policy) => Object.freeze({
-    name: policy.name,
-    origin: `veryfront/${policy.sourceDirectory}`,
-    sourceDirectory: policy.sourceDirectory,
-    ...(policy.evalExporterSelection
-        ? { evalExporterSelection: policy.evalExporterSelection }
-        : {}),
-    ...(policy.name === "ext-eval-report-mlflow"
-        ? {
+export const DEFERRED_BUILTIN_EXTENSIONS = Object.freeze(FIRST_PARTY_DEFERRED_BUILTIN_EXTENSION_POLICIES.map((policy) => {
+    const definition = {
+        name: policy.name,
+        origin: `veryfront/${policy.sourceDirectory}`,
+        sourceDirectory: policy.sourceDirectory,
+        ...(policy.evalExporterSelection
+            ? { evalExporterSelection: policy.evalExporterSelection }
+            : {}),
+    };
+    if (policy.name === "ext-eval-report-mlflow") {
+        return Object.freeze({
+            ...definition,
             // MLflow is deliberately shipped inside the root npm package rather
             // than published as a standalone extension package.
+            availability: "root-bundled",
             factory: extEvalReportMlflow,
-        }
-        : {}),
-})));
+        });
+    }
+    return Object.freeze({ ...definition, availability: "package" });
+}));
 function getOrCreateLLMProviderRegistry() {
     const existing = tryResolve(LLMProviderRegistryName);
     if (existing !== undefined)
@@ -107,51 +112,52 @@ function createBuiltinLLMProviderExtension(definition) {
         },
     };
 }
-export function createOptionalBuiltinExtension(definition) {
+export function createDeferredBuiltinExtension(definition) {
     const capturedDefinition = Object.freeze({ ...definition });
     return createDeferredResolvedExtension({
         name: capturedDefinition.name,
         source: "builtin",
         origin: capturedDefinition.origin,
-        load: (logger) => loadOptionalBuiltinExtension(capturedDefinition, logger),
+        load: (logger) => loadDeferredBuiltinExtension(capturedDefinition, logger),
     });
 }
-async function loadOptionalBuiltinExtension(definition, logger) {
-    const configuredFactory = definition.factory;
+async function loadDeferredBuiltinExtension(definition, logger) {
     try {
-        const factory = configuredFactory ?? await importOptionalBuiltinFactory(definition.sourceDirectory, getFirstPartyExtensionPackageName(definition));
+        const factory = definition.availability === "root-bundled"
+            ? definition.factory
+            : await importDeferredBuiltinFactory(definition.sourceDirectory, getFirstPartyExtensionPackageName(definition));
         const factoryResult = factory();
         const issues = validateExtension(factoryResult);
         if (issues.length > 0) {
             throw EXTENSION_VALIDATION_ERROR.create({
-                detail: `Optional builtin factory for "${definition.name}" returned an invalid extension: ${issues.join("; ")}`,
+                detail: `Deferred builtin factory for "${definition.name}" returned an invalid extension: ${issues.join("; ")}`,
             });
         }
         const extension = factoryResult;
         if (extension.name !== definition.name) {
             throw EXTENSION_VALIDATION_ERROR.create({
-                detail: `Optional builtin factory for "${definition.name}" returned extension "${extension.name}"`,
+                detail: `Deferred builtin factory for "${definition.name}" returned extension "${extension.name}"`,
             });
         }
         return extension;
     }
     catch (error) {
-        if (configuredFactory !== undefined ||
-            !isMissingOptionalBuiltinImplementation(error, definition)) {
+        if (definition.availability === "root-bundled" ||
+            !isMissingDeferredBuiltinImplementation(error, definition)) {
             throw error;
         }
         logger.debug(`Builtin extension "${definition.name}" is not available from the root package; install ${getFirstPartyExtensionPackageName(definition)} to enable it.`);
         return undefined;
     }
 }
-async function importOptionalBuiltinFactory(sourceDirectory, packageName) {
+async function importDeferredBuiltinFactory(sourceDirectory, packageName) {
     const mod = await importFirstPartyExtensionModule(sourceDirectory, packageName);
     if (typeof mod.default !== "function") {
         throw new Error(`Builtin extension "${sourceDirectory}" has no default factory export`);
     }
     return mod.default;
 }
-function isMissingOptionalBuiltinImplementation(error, definition) {
+function isMissingDeferredBuiltinImplementation(error, definition) {
     return isMissingFirstPartyExtensionModule(error, [
         `extensions/${definition.sourceDirectory}/src/index`,
         getFirstPartyExtensionPackageName(definition),
@@ -170,13 +176,13 @@ export function createBuiltinExtensions() {
             origin: "veryfront/ext-schema-zod",
             extension: extZod(),
         },
-        ...OPTIONAL_BUILTIN_EXTENSIONS.map(createOptionalBuiltinExtension),
+        ...DEFERRED_BUILTIN_EXTENSIONS.map(createDeferredBuiltinExtension),
         ...BUILTIN_LLM_PROVIDERS.map(createBuiltinLLMProviderExtension),
     ];
 }
 export function createEvalCliBuiltinExtensions(selectedExporterIds = []) {
     const selected = new Set(selectedExporterIds);
-    const exporterExtensions = OPTIONAL_BUILTIN_EXTENSIONS.filter((definition) => {
+    const exporterExtensions = DEFERRED_BUILTIN_EXTENSIONS.filter((definition) => {
         const selection = definition.evalExporterSelection;
         if (!selection)
             return false;
@@ -188,7 +194,7 @@ export function createEvalCliBuiltinExtensions(selectedExporterIds = []) {
             origin: "veryfront/ext-schema-zod",
             extension: extZod(),
         },
-        ...exporterExtensions.map(createOptionalBuiltinExtension),
+        ...exporterExtensions.map(createDeferredBuiltinExtension),
         ...BUILTIN_LLM_PROVIDERS.map(createBuiltinLLMProviderExtension),
     ];
 }

package/esm/src/extensions/deferred-extension.d.ts

@@ -1,10 +1,10 @@
 /**
- * Opaque pre-activation state for optional built-in extensions.
+ * Opaque pre-activation state for deferred built-in extensions.
  *
  * Public extension APIs continue to accept `ResolvedExtension`. A branded
- * resolved value lets the internal loader defer importing optional first-party
- * packages until after merge priority and disable filtering, without exposing
- * a second extension-authoring contract.
+ * resolved value lets the internal loader defer materializing first-party
+ * implementations until after merge priority and disable filtering, without
+ * exposing a second extension-authoring contract.
  */
 import type { Extension, ExtensionLogger, ExtensionSource, ResolvedExtension } from "./types.js";
 export interface DeferredExtensionState {

package/esm/src/extensions/deferred-extension.js

@@ -1,10 +1,10 @@
 /**
- * Opaque pre-activation state for optional built-in extensions.
+ * Opaque pre-activation state for deferred built-in extensions.
  *
  * Public extension APIs continue to accept `ResolvedExtension`. A branded
- * resolved value lets the internal loader defer importing optional first-party
- * packages until after merge priority and disable filtering, without exposing
- * a second extension-authoring contract.
+ * resolved value lets the internal loader defer materializing first-party
+ * implementations until after merge priority and disable filtering, without
+ * exposing a second extension-authoring contract.
  */
 import { assertCanonicalNonEmptyString } from "./runtime-validation.js";
 const DEFERRED_EXTENSION_STATE = Symbol("veryfront.deferred-extension-state");

package/esm/src/extensions/index.d.ts

@@ -22,6 +22,7 @@ export { composeAbortSignals } from "./abort-signal.js";
 export { resolve, tryResolve } from "./contracts.js";
 export type { DiscoveredPackageExtension, ExtensionActivationMode, PackageMetadata, } from "./discovery.js";
 export { discoverLocalExtensions, discoverPackageExtensions, discoverProjectExtensions, mergeExtensions, parsePackageMetadata, } from "./discovery.js";
+export { parseExtensionManifest } from "./manifest-reader.js";
 export { ExtensionLoader } from "./loader.js";
 export { loadExtensionFactory } from "./factory-loader.js";
 export type { OrchestrateOptions } from "./orchestrate.js";

package/esm/src/extensions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,yBAAyB,CAAC;AAEjC,YAAY,EACV,UAAU,EACV,SAAS,EACT,oBAAoB,EACpB,gBAAgB,EAChB,yBAAyB,EACzB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAKxD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGrD,YAAY,EACV,0BAA0B,EAC1B,uBAAuB,EACvB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,eAAe,EACf,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAGzD,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGrE,OAAO,EACL,0BAA0B,EAC1B,iBAAiB,EACjB,kBAAkB,EAClB,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGzD,OAAO,EACL,2BAA2B,EAC3B,KAAK,oBAAoB,EACzB,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,8BAA8B,GAC/B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,6BAA6B,EAC7B,8BAA8B,EAC9B,2BAA2B,EAC3B,iDAAiD,GAClD,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,4BAA4B,EAC5B,kBAAkB,EAClB,0BAA0B,EAC1B,uBAAuB,EACvB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,yBAAyB,CAAC;AAEjC,YAAY,EACV,UAAU,EACV,SAAS,EACT,oBAAoB,EACpB,gBAAgB,EAChB,yBAAyB,EACzB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAKxD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGrD,YAAY,EACV,0BAA0B,EAC1B,uBAAuB,EACvB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,eAAe,EACf,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAGzD,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGrE,OAAO,EACL,0BAA0B,EAC1B,iBAAiB,EACjB,kBAAkB,EAClB,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGzD,OAAO,EACL,2BAA2B,EAC3B,KAAK,oBAAoB,EACzB,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,8BAA8B,GAC/B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,6BAA6B,EAC7B,8BAA8B,EAC9B,2BAA2B,EAC3B,iDAAiD,GAClD,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,4BAA4B,EAC5B,kBAAkB,EAClB,0BAA0B,EAC1B,uBAAuB,EACvB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC"}

package/esm/src/extensions/index.js

@@ -25,6 +25,7 @@ export { composeAbortSignals } from "./abort-signal.js";
 // tests) and are intentionally not exported here.
 export { resolve, tryResolve } from "./contracts.js";
 export { discoverLocalExtensions, discoverPackageExtensions, discoverProjectExtensions, mergeExtensions, parsePackageMetadata, } from "./discovery.js";
+export { parseExtensionManifest } from "./manifest-reader.js";
 // Loader
 export { ExtensionLoader } from "./loader.js";
 // Factory loader (dynamic-import of an extension factory)