@avantf/dsh-plugin-base 0.4.1 → 0.5.1

package/dist/interface.d.ts

@@ -13,10 +13,10 @@
  *
  * The surface has TWO halves and they are named separately because they are checked differently:
  *
- *  - {@link BaseRuntimeV2} — the VALUE members of the CURRENT generation. A real module can be
+ *  - {@link BaseRuntimeV4} — the VALUE members of the CURRENT generation. A real module can be
  *    structurally assigned to it, so a missing or reshaped value member is a compile error, and
  *    `keyof` matches the runtime exports.
- *  - {@link BaseTypeSurfaceV2} — the TYPES a caller names when using those members (types are erased,
+ *  - {@link BaseTypeSurfaceV4} — the TYPES a caller names when using those members (types are erased,
  *    so no runtime value can carry them). `keyof` is the type-name list.
  *
  * GENERATIONS WERE ADDITIVE through v2, and that is what made `loaded > required ⇒ ok` sound:
@@ -26,12 +26,21 @@
  * {@link BaseRuntimeV2}. What keeps the newer-is-ok rule admissible is the replacement proof, asserted
  * in `test/public-surface.spec.ts`: `VALUE_NAMES_V3 ∪ PRUNED_VALUE_NAMES === VALUE_NAMES_V2` (nothing
  * was silently renamed or lost — every shed name is in the frozen {@link PRUNED_VALUE_NAMES}) and each
- * pruned name has zero consumers across the two plugin trees' non-test source and scripts. A generation
- * that drops a name with a consumer would fail that second half.
+ * pruned name has zero consumers across the DISCOVERED consumer trees' non-test source and scripts. A
+ * generation that drops a name with a consumer would fail that second half.
  *
- * `VALUE_NAMES_V1` / `TYPE_NAMES_V1` are the frozen v1 lists and `VALUE_NAMES_V2` / `TYPE_NAMES_V2`
- * the frozen v2 lists; `VALUE_NAMES_V3` / `TYPE_NAMES_V3` are the current ones. The v1/v2 interfaces
- * stay exported unchanged as their generations' records.
+ * **v4 changes no NAME** (INTERFACE.md §10): it is the generation in which the EXISTING member
+ * `verifyRegisteredFaces` accepts one more OPTIONAL input field (`scope?: unknown`), so a host whose
+ * tools registry is addressed per scope can be read back through it. The name surface is therefore
+ * identical to v3 in both halves — `VALUE_NAMES_V4` / `TYPE_NAMES_V4` are exactly the v3 lists — which
+ * `test/public-surface.spec.ts` asserts rather than assumes. Adding an optional, named field is how a
+ * signature grows without taking anything away; it is still an interface change (the meaning of what
+ * the member accepts), so the generation moved.
+ *
+ * `VALUE_NAMES_V1` / `TYPE_NAMES_V1` are the frozen v1 lists, `VALUE_NAMES_V2` / `TYPE_NAMES_V2` the
+ * frozen v2 lists, and `VALUE_NAMES_V3` / `TYPE_NAMES_V3` the frozen v3 lists;
+ * `VALUE_NAMES_V4` / `TYPE_NAMES_V4` are the current ones. The v1/v2/v3 interfaces stay exported
+ * unchanged as their generations' records.
  *
  * The name lists are the same surface as data, because the snapshot gate needs to compare string sets.
  * The gate asserts they are exactly the two `keyof`s, so a member can never be added to the interface
@@ -40,7 +49,8 @@
  * `INTERFACE_VERSION` is the integer the plugins bake at build time and compare against the value
  * reported by the base they actually loaded at startup. It moves only for an INTERFACE change (the set
  * of names below, a signature in it, or the meaning of a member) — not for a behaviour/flow change and
- * not for a fix. The package version remains the INSTALL-time gate (the plugin's peer range); this
+ * not for a fix. The package version remains the INSTALL-time gate (the plugin's declared
+ * `dependencies` range); this
  * constant is the RUNTIME one.
  *
  * @module @avantf/dsh-plugin-base/interface
@@ -58,19 +68,22 @@ import type { AtStartup, AtUse, BuiltinKind, Disposable, EnsureOptions, InstallC
 /**
  * The integer interface generation this module implements.
  *
- * `3` is the CURRENT generation: the v2 surface MINUS the 18 zero-consumer members that moved to
- * `./internal` (INTERFACE.md §9) and PLUS the one newly-named compat type (`ServiceContract`). The
+ * `4` is the CURRENT generation: the v3 NAME surface UNCHANGED, with one member's accepted input
+ * widened — `verifyRegisteredFaces` now takes an optional, opaque `scope` and hands it to
+ * `tools.get(name, scope)` (INTERFACE.md §10). Nothing was added to or removed from `.`; what moved is
+ * what an existing member accepts, which is an interface change all the same (INTERFACE.md §1). The
  * file name's `N` and this constant are the SAME fact — `test/public-surface.spec.ts` asserts that the
  * snapshot for this constant exists and that its `interfaceVersion` field equals it, so "the JSON says
- * v4, the constant says 3" cannot happen. Bump it (and add `api/interface-vN.json`) only for an
+ * v5, the constant says 4" cannot happen. Bump it (and add `api/interface-vN.json`) only for an
  * interface change (INTERFACE.md §1); a behaviour change or a fix does NOT touch it. The plugins bake
  * this number into their artifacts and compare it, at startup, with the number the base they loaded
  * reports — a difference is a warning and a capability-level degradation, never a refused mount.
  *
- * `2` and `1` are the earlier frozen generations (`api/interface-v2.json`, `api/interface-v1.json`).
- * They stay in the tree as those generations' records and as the types the plugins still import.
+ * `3`, `2` and `1` are the earlier frozen generations (`api/interface-v3.json`,
+ * `api/interface-v2.json`, `api/interface-v1.json`). They stay in the tree as those generations'
+ * records and as the types callers compiled against still import.
  */
-export declare const INTERFACE_VERSION = 3;
+export declare const INTERFACE_VERSION = 4;
 /**
  * The VALUE half of the v1 `.` surface: every member that exists at runtime.
  *
@@ -196,7 +209,7 @@ export interface BaseRuntimeV1 {
     readonly MODEL_CACHE_KIND: typeof import('./providers/model.js').MODEL_CACHE_KIND;
 }
 /**
- * The VALUE half of the FROZEN v2 `.` surface: v1 plus the well-formed-text kit. It stays exported as that generation's record; the CURRENT generation is {@link BaseRuntimeV3}.
+ * The VALUE half of the FROZEN v2 `.` surface: v1 plus the well-formed-text kit. It stays exported as that generation's record; the CURRENT generation is {@link BaseRuntimeV4}.
  *
  * Additive by construction — it `extends` {@link BaseRuntimeV1}, so a v2 that dropped or reshaped a v1
  * member is a compile error, and `keyof BaseRuntimeV2` is exactly v1's members plus the two below. The
@@ -221,18 +234,24 @@ export interface BaseRuntimeV2 extends BaseRuntimeV1 {
     readonly wellFormedDeep: typeof import('./kit/wellformed.js').wellFormedDeep;
 }
 /**
- * The VALUE half of the CURRENT (v3) `.` surface: the STABLE SUBSET the installed plugins consume.
+ * The VALUE half of the FROZEN v3 `.` surface: the STABLE SUBSET the installed plugins consume.
  *
  * v3 does NOT `extends` {@link BaseRuntimeV2} — it is the first pruning generation (INTERFACE.md §9).
- * The 18 members with zero consumers across both plugin trees moved to `./internal`
+ * The 18 members with zero consumers across the discovered consumer trees moved to `./internal`
  * ({@link PRUNED_VALUE_NAMES}); the 32 below are what is left, and every one is either taken off the
- * loaded module by a plugin today or is an extension point a plugin author is meant to call
- * (`createProvisioner` + providers, family paths, the gate, the provisioner error type).
+ * loaded module by a plugin today OR registered as an extension point in `test/public-surface.spec.ts`'s
+ * `EXTENSION_POINTS` — an author-facing entry point the family's own plugins happen not to read (the
+ * verdict/gather pair, the family paths, `reasonOf`, `INTERFACE_VERSION`, the provisioner + providers).
+ * That consumer-or-registration split is a GATE there, not prose: a `.` member that is neither read by
+ * a tree nor registered is red.
  *
  * A real v3 module is still structurally a v1/v2 module — the shed values remain reachable through the
  * package (`./internal` and the `./compat` subpath) and, in practice, plugins never named them — but
  * that is a consumer-level fact proven in `test/public-surface.spec.ts`, not a structural one, which
  * is exactly why the generation number moved.
+ *
+ * v3 stays exported as that generation's record; the CURRENT generation is {@link BaseRuntimeV4}, whose
+ * NAME surface is exactly this one (v4 only widened `verifyRegisteredFaces`'s input, INTERFACE.md §10).
  */
 export interface BaseRuntimeV3 {
     /** The interface generation; see {@link INTERFACE_VERSION}. */
@@ -300,6 +319,91 @@ export interface BaseRuntimeV3 {
     /** The model-cache item kind. */
     readonly MODEL_CACHE_KIND: typeof import('./providers/model.js').MODEL_CACHE_KIND;
 }
+/**
+ * The VALUE half of the CURRENT (v4) `.` surface.
+ *
+ * **v4 adds no name**: it is the v3 list, member for member ({@link VALUE_NAMES_V4} is asserted to be
+ * exactly {@link VALUE_NAMES_V3}). The generation moved because an EXISTING member's accepted input
+ * changed: `verifyRegisteredFaces` now takes an optional `scope` and passes it through to
+ * `tools.get(name, scope)` (INTERFACE.md §10). Members are declared here rather than inherited so this
+ * interface is the CURRENT generation's own name carrier — `test/public-surface.spec.ts` assigns a real
+ * module to it and derives the snapshot from it, which is what makes the v3 record above historical
+ * rather than "the same thing under two names".
+ *
+ * The one signature to read closely is {@link BaseRuntimeV4.verifyRegisteredFaces}: base has no DSH
+ * dependency and does not know what a scope is, so the field is typed `unknown` and passed through
+ * opaquely. It is optional, so a caller that omits it keeps the older one-argument reading exactly.
+ */
+export interface BaseRuntimeV4 {
+    /** The interface generation; see {@link INTERFACE_VERSION}. */
+    readonly INTERFACE_VERSION: typeof INTERFACE_VERSION;
+    /** The compat log token (`compat:`) every line the gate emits begins with. */
+    readonly COMPAT_PREFIX: typeof import('./compat.js').COMPAT_PREFIX;
+    /** The baked build-record file name (`dsh-build.json`) read beside a plugin's entry. */
+    readonly BUILD_VERSIONS_FILE: typeof import('./compat.js').BUILD_VERSIONS_FILE;
+    /** The item schema generation this build understands. */
+    readonly ITEM_SCHEMA_VERSION: typeof import('./provisioner.js').ITEM_SCHEMA_VERSION;
+    /** Decide whether a loaded module implements the interface generation a caller requires. */
+    readonly checkInterface: typeof import('./interface_gate.js').checkInterface;
+    /** Read the `{ baseVersion, interfaceVersion }` record a plugin artifact was baked with. */
+    readonly readInterfaceRequirement: typeof import('./interface_gate.js').readInterfaceRequirement;
+    /** Run the gate against a live context: register nothing, decide `load`, log the diagnosis. */
+    readonly provision: typeof import('./compat.js').provision;
+    /** Build the refusal report from a verdict plus the CALLER's wording. */
+    readonly compatReport: typeof import('./compat.js').compatReport;
+    /** Keep one user-visible command that reports a refusal (the only channel on that path). */
+    readonly registerMegaphone: typeof import('./compat.js').registerMegaphone;
+    /** The wire schema names a contribution declares (the post-registration check's input). */
+    readonly schemaNamesFrom: typeof import('./compat.js').schemaNamesFrom;
+    /**
+     * Confirm, after mounting, that every declared schema and tool is really registered. Takes an
+     * optional opaque `scope` (the v4 widening) and reads each tool back with it — `tools.get(name,
+     * scope)` — so a per-scope registration is not reported as a false "missing".
+     */
+    readonly verifyRegisteredFaces: typeof import('./compat.js').verifyRegisteredFaces;
+    /** The peer-range FLOORS of the packages that identify the host (the `declared` fallback). */
+    readonly readDeclaredVersions: typeof import('./compat.js').readDeclaredVersions;
+    /** The versions this BUILD was compiled against, baked next to the entry. */
+    readonly readBuildVersions: typeof import('./compat.js').readBuildVersions;
+    /** The versions THIS build's links resolve to at startup. */
+    readonly readRuntimeVersions: typeof import('./compat.js').readRuntimeVersions;
+    /** Build the probe tool declaration from the caller's own `defineTool`. */
+    readonly toolProbeDeclaration: typeof import('./compat.js').toolProbeDeclaration;
+    /** The rules as a pure function of evidence (no host, no I/O). */
+    readonly verdictOf: typeof import('./compat.js').verdictOf;
+    /** Gather the plain evidence {@link BaseRuntimeV4.verdictOf} consumes from a live context. */
+    readonly gatherEvidence: typeof import('./compat.js').gatherEvidence;
+    /** Ensure + read the family's user-editable prompt files. */
+    readonly PromptFiles: typeof import('./kit/prompt_files.js').PromptFiles;
+    /** The family root: `$AVANTF_HOME`, else `~/.avantf/env`. */
+    readonly familyHome: typeof import('./kit/family.js').familyHome;
+    /** `<family root>/tools`. */
+    readonly familyToolsDir: typeof import('./kit/family.js').familyToolsDir;
+    /** `<family root>/models`. */
+    readonly familyModelsDir: typeof import('./kit/family.js').familyModelsDir;
+    /** The DATA root, by the family's layer order: ⑤ explicit → ④ `$AVANTF_HOME` → ② configured → `~/.avantf`. */
+    readonly resolveDataHome: typeof import('./kit/family.js').resolveDataHome;
+    /** `~/x` → `<home>/x`, `~` → `<home>`; anything else unchanged. */
+    readonly expandHome: typeof import('./kit/family.js').expandHome;
+    /** Repair lone surrogates in ONE string (U+FFFD), engine-independent and total. */
+    readonly wellFormedText: typeof import('./kit/wellformed.js').wellFormedText;
+    /** {@link BaseRuntimeV4.wellFormedText} over a JSON-shaped value. */
+    readonly wellFormedDeep: typeof import('./kit/wellformed.js').wellFormedDeep;
+    /** Build a provisioner over a family root. */
+    readonly createProvisioner: typeof import('./provisioner.js').createProvisioner;
+    /** The error a failed provision throws, with its machine-readable `code`. */
+    readonly ProvisionError: typeof import('./errors.js').ProvisionError;
+    /** The machine-readable code of a provision failure. */
+    readonly reasonOf: typeof import('./errors.js').reasonOf;
+    /** The binary-archive provider factory. */
+    readonly binaryArchiveProvider: typeof import('./providers/archive.js').binaryArchiveProvider;
+    /** The binary-archive item kind. */
+    readonly BINARY_ARCHIVE_KIND: typeof import('./providers/archive.js').BINARY_ARCHIVE_KIND;
+    /** The model-cache provider factory. */
+    readonly modelCacheProvider: typeof import('./providers/model.js').modelCacheProvider;
+    /** The model-cache item kind. */
+    readonly MODEL_CACHE_KIND: typeof import('./providers/model.js').MODEL_CACHE_KIND;
+}
 /**
  * The TYPE half of the v1 `.` surface: every type a caller names when it uses the members above.
  *
@@ -377,7 +481,7 @@ export interface BaseTypeSurfaceV1 {
     readonly InterfaceRequirement: InterfaceRequirement;
 }
 /**
- * The TYPE half of the FROZEN v2 `.` surface. It stays exported as that generation's record; the CURRENT generation is {@link BaseTypeSurfaceV3}.
+ * The TYPE half of the FROZEN v2 `.` surface. It stays exported as that generation's record; the CURRENT generation is {@link BaseTypeSurfaceV4}.
  *
  * v2 is additive at runtime only: the well-formed-text helpers take and return `string` / a generic
  * `T`, so they introduce no named type. This interface therefore adds nothing to
@@ -387,7 +491,8 @@ export interface BaseTypeSurfaceV1 {
 export interface BaseTypeSurfaceV2 extends BaseTypeSurfaceV1 {
 }
 /**
- * The TYPE half of the CURRENT (v3) `.` surface.
+ * The TYPE half of the FROZEN v3 `.` surface. It stays exported as that generation's record; the
+ * CURRENT generation is {@link BaseTypeSurfaceV4}, whose name list is exactly this one.
  *
  * v3 does NOT `extends` {@link BaseTypeSurfaceV2}: it is the pruning generation. It drops the four
  * types that existed only for the shed values (`StrictCodec`, `PluginLogger`, `PluginLoggerHost`,
@@ -464,6 +569,84 @@ export interface BaseTypeSurfaceV3 {
     InterfaceRequirement: InterfaceRequirement;
     InterfaceVerdict: InterfaceVerdict;
 }
+/**
+ * The TYPE half of the CURRENT (v4) `.` surface.
+ *
+ * **v4 names no new type and sheds none**: it is the v3 list, entry for entry ({@link TYPE_NAMES_V4}
+ * is exactly {@link TYPE_NAMES_V3}). It exists because the generation's type half must have a carrier
+ * of its own — the snapshot's type list is derived from THIS interface, and `checkInterface`'s
+ * newer-is-ok rule is stated per generation — while the widening that produced v4
+ * (`verifyRegisteredFaces`'s optional `scope`, INTERFACE.md §10) introduces no named type at all: the
+ * field is `unknown` on purpose, because base does not know what a scope is.
+ */
+export interface BaseTypeSurfaceV4 {
+    ArchivePack: ArchivePack;
+    BinaryArchiveSpec: BinaryArchiveSpec;
+    ModelCacheLayout: ModelCacheLayout;
+    ModelCacheSpec: ModelCacheSpec;
+    ProvisionCode: ProvisionCode;
+    AtStartup: AtStartup;
+    AtUse: AtUse;
+    BuiltinKind: BuiltinKind;
+    Disposable: Disposable;
+    EnsureOptions: EnsureOptions;
+    InstallContext: InstallContext;
+    InstallManifest: InstallManifest;
+    ItemPolicy: ItemPolicy;
+    Kind: Kind;
+    Manifest: Manifest;
+    MirrorPolicy: MirrorPolicy;
+    OnMissing: OnMissing;
+    Plan: Plan;
+    PlanAction: PlanAction;
+    PlanEntry: PlanEntry;
+    PlanOptions: PlanOptions;
+    ProbeResult: ProbeResult;
+    ProgressEvent: ProgressEvent;
+    Provider: Provider;
+    ProviderContext: ProviderContext;
+    ProviderPlan: ProviderPlan;
+    ProvisionEvent: ProvisionEvent;
+    ProvisionFs: ProvisionFs;
+    ProvisionItem: ProvisionItem;
+    ProvisionLock: ProvisionLock;
+    ProvisionLogger: ProvisionLogger;
+    ProvisionPolicy: ProvisionPolicy;
+    ProvisionReport: ProvisionReport;
+    ProvisionReportEntry: ProvisionReportEntry;
+    ProvisionStatus: ProvisionStatus;
+    Provisioner: Provisioner;
+    ProvisionerExperimental: ProvisionerExperimental;
+    ProvisionerOptions: ProvisionerOptions;
+    PrunePolicy: PrunePolicy;
+    PruneReport: PruneReport;
+    PublishMeta: PublishMeta;
+    ReportAction: ReportAction;
+    Resolved: Resolved;
+    ResourceHandle: ResourceHandle;
+    ResourceIdentity: ResourceIdentity;
+    ResourceSource: ResourceSource;
+    ResourceState: ResourceState;
+    Startup: Startup;
+    CompatContext: CompatContext;
+    CompatEvidence: CompatEvidence;
+    CompatLine: CompatLine;
+    CompatLogger: CompatLogger;
+    CompatReportWords: CompatReportWords;
+    CompatSpec: CompatSpec;
+    CompatVerdict: CompatVerdict;
+    ProbeOutcome: ProbeOutcome;
+    ServiceContract: ServiceContract;
+    ServiceProbe: ServiceProbe;
+    DataHomeInput: DataHomeInput;
+    LoadedPromptText: LoadedPromptText;
+    PromptFileSpec: PromptFileSpec;
+    PromptFilesIo: PromptFilesIo;
+    PromptFilesLogger: PromptFilesLogger;
+    PromptFilesOptions: PromptFilesOptions;
+    InterfaceRequirement: InterfaceRequirement;
+    InterfaceVerdict: InterfaceVerdict;
+}
 /**
  * Every VALUE name of the v1 `.` surface, in {@link BaseRuntimeV1} declaration order.
  *
@@ -499,21 +682,32 @@ export declare const TYPE_NAMES_V2: readonly ["EnsureOptions", "InstallContext",
 /**
  * The VALUE names v3 shed from `.` — the frozen PRUNE list (INTERFACE.md §9).
  *
- * Every one of them has zero consumers across the two plugin trees' non-test source and scripts (the
- * proof is `PUBLIC-SURFACE`'s cross-tree check), and every one of them now lives on `./internal`
- * instead. This list is not documentation: `test/public-surface.spec.ts` asserts
+ * Every one of them has zero consumers across the discovered consumer trees' non-test source and
+ * scripts (the proof is `PUBLIC-SURFACE`'s cross-tree check), and every one of them now lives on
+ * `./internal` instead. This list is not documentation: `test/public-surface.spec.ts` asserts
  * `VALUE_NAMES_V2 === [...VALUE_NAMES_V3, ...PRUNED_VALUE_NAMES]` (both directions), so a v4 cannot
  * quietly drop a name that is neither in the surface nor on this list.
  */
 export declare const PRUNED_VALUE_NAMES: readonly ["CAPABILITIES", "COMPAT_PROBE_TOOL", "DEFAULT_DEADLINE_MS", "NPM_PACKAGE_KIND", "checkInterval", "checkServices", "createPluginLogger", "declaredSchemaKeys", "endpointId", "fieldSymbol", "floorOf", "normalizeOnMissing", "npmPackageProvider", "probeToolsRegistry", "probeTypertRegistry", "resolveRuntimeVersion", "resultSymbol", "strictCodec"];
 /**
- * Every VALUE name of the CURRENT (v3) `.` surface, in {@link BaseRuntimeV3} declaration order.
+ * Every VALUE name of the FROZEN v3 `.` surface, in {@link BaseRuntimeV3} declaration order.
  *
  * NOT a spread of v2: v3 prunes, so it is stated as itself. The `satisfies` clause ties it to
  * {@link BaseRuntimeV3}, and the gate asserts the whole `keyof`, so a member added to the interface
- * and not to this list is a compile error.
+ * and not to this list is a compile error. v3 stays frozen as that generation's record;
+ * {@link VALUE_NAMES_V4} is the current list, exactly this one.
  */
 export declare const VALUE_NAMES_V3: readonly ["INTERFACE_VERSION", "COMPAT_PREFIX", "BUILD_VERSIONS_FILE", "ITEM_SCHEMA_VERSION", "checkInterface", "readInterfaceRequirement", "provision", "compatReport", "registerMegaphone", "schemaNamesFrom", "verifyRegisteredFaces", "readDeclaredVersions", "readBuildVersions", "readRuntimeVersions", "toolProbeDeclaration", "verdictOf", "gatherEvidence", "PromptFiles", "familyHome", "familyToolsDir", "familyModelsDir", "resolveDataHome", "expandHome", "wellFormedText", "wellFormedDeep", "createProvisioner", "ProvisionError", "reasonOf", "binaryArchiveProvider", "BINARY_ARCHIVE_KIND", "modelCacheProvider", "MODEL_CACHE_KIND"];
+/**
+ * Every VALUE name of the CURRENT (v4) `.` surface, in {@link BaseRuntimeV4} declaration order.
+ *
+ * The spread is the whole point of this generation: v4 adds no name, so the list is stated as "the v3
+ * list verbatim" and `test/public-surface.spec.ts` asserts equality with {@link VALUE_NAMES_V3} — both
+ * the set and the order, so neither half of that claim can drift silently. The `satisfies` clause
+ * still checks the whole v4 `keyof`, so a member added to {@link BaseRuntimeV4} and not here is a
+ * compile error.
+ */
+export declare const VALUE_NAMES_V4: readonly ["INTERFACE_VERSION", "COMPAT_PREFIX", "BUILD_VERSIONS_FILE", "ITEM_SCHEMA_VERSION", "checkInterface", "readInterfaceRequirement", "provision", "compatReport", "registerMegaphone", "schemaNamesFrom", "verifyRegisteredFaces", "readDeclaredVersions", "readBuildVersions", "readRuntimeVersions", "toolProbeDeclaration", "verdictOf", "gatherEvidence", "PromptFiles", "familyHome", "familyToolsDir", "familyModelsDir", "resolveDataHome", "expandHome", "wellFormedText", "wellFormedDeep", "createProvisioner", "ProvisionError", "reasonOf", "binaryArchiveProvider", "BINARY_ARCHIVE_KIND", "modelCacheProvider", "MODEL_CACHE_KIND"];
 /**
  * The TYPE names v3 NAMES for the first time — they were reachable through `export *` in v2 but were
  * never declared in {@link BaseTypeSurfaceV2}, so they had no entry and no promise. v3's explicit
@@ -526,10 +720,19 @@ export declare const ADDED_TYPE_NAMES: readonly ["ArchivePack", "AtStartup", "At
  */
 export declare const PRUNED_TYPE_NAMES: readonly ["PluginLogger", "PluginLoggerHost", "PluginLoggerOptions", "StrictCodec"];
 /**
- * Every TYPE name of the CURRENT (v3) `.` surface, in {@link BaseTypeSurfaceV3} declaration order.
+ * Every TYPE name of the FROZEN v3 `.` surface, in {@link BaseTypeSurfaceV3} declaration order.
  *
  * v3 is a pruning generation, so this is stated explicitly rather than spread. The gate asserts it
- * partitions v2 together with {@link PRUNED_TYPE_NAMES} and {@link ADDED_TYPE_NAMES}.
+ * partitions v2 together with {@link PRUNED_TYPE_NAMES} and {@link ADDED_TYPE_NAMES}. v3 stays frozen
+ * as that generation's record; {@link TYPE_NAMES_V4} is the current list, exactly this one.
  */
 export declare const TYPE_NAMES_V3: readonly ["ArchivePack", "BinaryArchiveSpec", "ModelCacheLayout", "ModelCacheSpec", "ProvisionCode", "AtStartup", "AtUse", "BuiltinKind", "Disposable", "EnsureOptions", "InstallContext", "InstallManifest", "ItemPolicy", "Kind", "Manifest", "MirrorPolicy", "OnMissing", "Plan", "PlanAction", "PlanEntry", "PlanOptions", "ProbeResult", "ProgressEvent", "Provider", "ProviderContext", "ProviderPlan", "ProvisionEvent", "ProvisionFs", "ProvisionItem", "ProvisionLock", "ProvisionLogger", "ProvisionPolicy", "ProvisionReport", "ProvisionReportEntry", "ProvisionStatus", "Provisioner", "ProvisionerExperimental", "ProvisionerOptions", "PrunePolicy", "PruneReport", "PublishMeta", "ReportAction", "Resolved", "ResourceHandle", "ResourceIdentity", "ResourceSource", "ResourceState", "Startup", "CompatContext", "CompatEvidence", "CompatLine", "CompatLogger", "CompatReportWords", "CompatSpec", "CompatVerdict", "ProbeOutcome", "ServiceContract", "ServiceProbe", "DataHomeInput", "LoadedPromptText", "PromptFileSpec", "PromptFilesIo", "PromptFilesLogger", "PromptFilesOptions", "InterfaceRequirement", "InterfaceVerdict"];
+/**
+ * Every TYPE name of the CURRENT (v4) `.` surface, in {@link BaseTypeSurfaceV4} declaration order.
+ *
+ * Like {@link VALUE_NAMES_V4}, the spread states the fact this generation is about: v4 names no new type
+ * and sheds none, so the list is the v3 list verbatim. `test/public-surface.spec.ts` asserts equality
+ * with {@link TYPE_NAMES_V3}, and the `satisfies` clause ties it to the whole v4 `keyof`.
+ */
+export declare const TYPE_NAMES_V4: readonly ["ArchivePack", "BinaryArchiveSpec", "ModelCacheLayout", "ModelCacheSpec", "ProvisionCode", "AtStartup", "AtUse", "BuiltinKind", "Disposable", "EnsureOptions", "InstallContext", "InstallManifest", "ItemPolicy", "Kind", "Manifest", "MirrorPolicy", "OnMissing", "Plan", "PlanAction", "PlanEntry", "PlanOptions", "ProbeResult", "ProgressEvent", "Provider", "ProviderContext", "ProviderPlan", "ProvisionEvent", "ProvisionFs", "ProvisionItem", "ProvisionLock", "ProvisionLogger", "ProvisionPolicy", "ProvisionReport", "ProvisionReportEntry", "ProvisionStatus", "Provisioner", "ProvisionerExperimental", "ProvisionerOptions", "PrunePolicy", "PruneReport", "PublishMeta", "ReportAction", "Resolved", "ResourceHandle", "ResourceIdentity", "ResourceSource", "ResourceState", "Startup", "CompatContext", "CompatEvidence", "CompatLine", "CompatLogger", "CompatReportWords", "CompatSpec", "CompatVerdict", "ProbeOutcome", "ServiceContract", "ServiceProbe", "DataHomeInput", "LoadedPromptText", "PromptFileSpec", "PromptFilesIo", "PromptFilesLogger", "PromptFilesOptions", "InterfaceRequirement", "InterfaceVerdict"];
 //# sourceMappingURL=interface.d.ts.map

package/dist/interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../src/interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACrL,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAC1F,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AACnI,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,KAAK,EACV,SAAS,EACT,KAAK,EACL,WAAW,EACX,UAAU,EACV,aAAa,EACb,cAAc,EACd,eAAe,EACf,UAAU,EACV,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,IAAI,EACJ,UAAU,EACV,SAAS,EACT,WAAW,EACX,WAAW,EACX,aAAa,EACb,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,cAAc,EACd,WAAW,EACX,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,uBAAuB,EACvB,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,OAAO,EACR,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB,IAAI,CAAA;AAElC;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,aAAa;IAE5B,+DAA+D;IAC/D,QAAQ,CAAC,iBAAiB,EAAE,OAAO,iBAAiB,CAAA;IACpD,8EAA8E;IAC9E,QAAQ,CAAC,aAAa,EAAE,cAAc,aAAa,EAAE,aAAa,CAAA;IAClE,wFAAwF;IACxF,QAAQ,CAAC,mBAAmB,EAAE,cAAc,aAAa,EAAE,mBAAmB,CAAA;IAC9E,gEAAgE;IAChE,QAAQ,CAAC,iBAAiB,EAAE,cAAc,aAAa,EAAE,iBAAiB,CAAA;IAC1E,yDAAyD;IACzD,QAAQ,CAAC,mBAAmB,EAAE,cAAc,kBAAkB,EAAE,mBAAmB,CAAA;IACnF,oDAAoD;IACpD,QAAQ,CAAC,mBAAmB,EAAE,cAAc,kBAAkB,EAAE,mBAAmB,CAAA;IACnF,yCAAyC;IACzC,QAAQ,CAAC,YAAY,EAAE,cAAc,kBAAkB,EAAE,YAAY,CAAA;IAGrE;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,EAAE,cAAc,qBAAqB,EAAE,cAAc,CAAA;IAC5E;;;OAGG;IACH,QAAQ,CAAC,wBAAwB,EAAE,cAAc,qBAAqB,EAAE,wBAAwB,CAAA;IAGhG,+FAA+F;IAC/F,QAAQ,CAAC,SAAS,EAAE,cAAc,aAAa,EAAE,SAAS,CAAA;IAC1D,yEAAyE;IACzE,QAAQ,CAAC,YAAY,EAAE,cAAc,aAAa,EAAE,YAAY,CAAA;IAChE,4FAA4F;IAC5F,QAAQ,CAAC,iBAAiB,EAAE,cAAc,aAAa,EAAE,iBAAiB,CAAA;IAC1E,2FAA2F;IAC3F,QAAQ,CAAC,eAAe,EAAE,cAAc,aAAa,EAAE,eAAe,CAAA;IACtE,yFAAyF;IACzF,QAAQ,CAAC,qBAAqB,EAAE,cAAc,aAAa,EAAE,qBAAqB,CAAA;IAClF,8FAA8F;IAC9F,QAAQ,CAAC,oBAAoB,EAAE,cAAc,aAAa,EAAE,oBAAoB,CAAA;IAChF,6EAA6E;IAC7E,QAAQ,CAAC,iBAAiB,EAAE,cAAc,aAAa,EAAE,iBAAiB,CAAA;IAC1E,6DAA6D;IAC7D,QAAQ,CAAC,mBAAmB,EAAE,cAAc,aAAa,EAAE,mBAAmB,CAAA;IAC9E,2EAA2E;IAC3E,QAAQ,CAAC,oBAAoB,EAAE,cAAc,aAAa,EAAE,oBAAoB,CAAA;IAChF,kEAAkE;IAClE,QAAQ,CAAC,SAAS,EAAE,cAAc,aAAa,EAAE,SAAS,CAAA;IAC1D,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,cAAc,aAAa,EAAE,OAAO,CAAA;IACtD,kEAAkE;IAClE,QAAQ,CAAC,qBAAqB,EAAE,cAAc,aAAa,EAAE,qBAAqB,CAAA;IAClF,oFAAoF;IACpF,QAAQ,CAAC,aAAa,EAAE,cAAc,aAAa,EAAE,aAAa,CAAA;IAClE,6FAA6F;IAC7F,QAAQ,CAAC,aAAa,EAAE,cAAc,aAAa,EAAE,aAAa,CAAA;IAClE,gFAAgF;IAChF,QAAQ,CAAC,cAAc,EAAE,cAAc,aAAa,EAAE,cAAc,CAAA;IACpE,+FAA+F;IAC/F,QAAQ,CAAC,kBAAkB,EAAE,cAAc,aAAa,EAAE,kBAAkB,CAAA;IAC5E,0EAA0E;IAC1E,QAAQ,CAAC,mBAAmB,EAAE,cAAc,aAAa,EAAE,mBAAmB,CAAA;IAC9E,gFAAgF;IAChF,QAAQ,CAAC,kBAAkB,EAAE,cAAc,aAAa,EAAE,kBAAkB,CAAA;IAG5E,6DAA6D;IAC7D,QAAQ,CAAC,WAAW,EAAE,cAAc,uBAAuB,EAAE,WAAW,CAAA;IACxE,2EAA2E;IAC3E,QAAQ,CAAC,kBAAkB,EAAE,cAAc,iBAAiB,EAAE,kBAAkB,CAAA;IAChF,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE,cAAc,iBAAiB,EAAE,UAAU,CAAA;IAChE,6BAA6B;IAC7B,QAAQ,CAAC,cAAc,EAAE,cAAc,iBAAiB,EAAE,cAAc,CAAA;IACxE,8BAA8B;IAC9B,QAAQ,CAAC,eAAe,EAAE,cAAc,iBAAiB,EAAE,eAAe,CAAA;IAC1E;;;;OAIG;IACH,QAAQ,CAAC,eAAe,EAAE,cAAc,iBAAiB,EAAE,eAAe,CAAA;IAC1E,mEAAmE;IACnE,QAAQ,CAAC,UAAU,EAAE,cAAc,iBAAiB,EAAE,UAAU,CAAA;IAChE,iFAAiF;IACjF,QAAQ,CAAC,WAAW,EAAE,cAAc,iBAAiB,EAAE,WAAW,CAAA;IAClE,wCAAwC;IACxC,QAAQ,CAAC,UAAU,EAAE,cAAc,iBAAiB,EAAE,UAAU,CAAA;IAChE,kDAAkD;IAClD,QAAQ,CAAC,WAAW,EAAE,cAAc,iBAAiB,EAAE,WAAW,CAAA;IAClE,4CAA4C;IAC5C,QAAQ,CAAC,YAAY,EAAE,cAAc,iBAAiB,EAAE,YAAY,CAAA;IAGpE,8CAA8C;IAC9C,QAAQ,CAAC,iBAAiB,EAAE,cAAc,kBAAkB,EAAE,iBAAiB,CAAA;IAC/E,iEAAiE;IACjE,QAAQ,CAAC,kBAAkB,EAAE,cAAc,kBAAkB,EAAE,kBAAkB,CAAA;IACjF,6EAA6E;IAC7E,QAAQ,CAAC,cAAc,EAAE,cAAc,aAAa,EAAE,cAAc,CAAA;IACpE,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,cAAc,aAAa,EAAE,QAAQ,CAAA;IACxD,2CAA2C;IAC3C,QAAQ,CAAC,qBAAqB,EAAE,cAAc,wBAAwB,EAAE,qBAAqB,CAAA;IAC7F,oCAAoC;IACpC,QAAQ,CAAC,mBAAmB,EAAE,cAAc,wBAAwB,EAAE,mBAAmB,CAAA;IACzF,wCAAwC;IACxC,QAAQ,CAAC,kBAAkB,EAAE,cAAc,oBAAoB,EAAE,kBAAkB,CAAA;IACnF,iCAAiC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,cAAc,oBAAoB,EAAE,gBAAgB,CAAA;IAC/E,wCAAwC;IACxC,QAAQ,CAAC,kBAAkB,EAAE,cAAc,sBAAsB,EAAE,kBAAkB,CAAA;IACrF,iCAAiC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,cAAc,sBAAsB,EAAE,gBAAgB,CAAA;CAClF;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,EAAE,cAAc,qBAAqB,EAAE,cAAc,CAAA;IAC5E;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,cAAc,qBAAqB,EAAE,cAAc,CAAA;CAC7E;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,aAAa;IAE5B,+DAA+D;IAC/D,QAAQ,CAAC,iBAAiB,EAAE,OAAO,iBAAiB,CAAA;IACpD,8EAA8E;IAC9E,QAAQ,CAAC,aAAa,EAAE,cAAc,aAAa,EAAE,aAAa,CAAA;IAClE,wFAAwF;IACxF,QAAQ,CAAC,mBAAmB,EAAE,cAAc,aAAa,EAAE,mBAAmB,CAAA;IAC9E,yDAAyD;IACzD,QAAQ,CAAC,mBAAmB,EAAE,cAAc,kBAAkB,EAAE,mBAAmB,CAAA;IAGnF,4FAA4F;IAC5F,QAAQ,CAAC,cAAc,EAAE,cAAc,qBAAqB,EAAE,cAAc,CAAA;IAC5E,4FAA4F;IAC5F,QAAQ,CAAC,wBAAwB,EAAE,cAAc,qBAAqB,EAAE,wBAAwB,CAAA;IAGhG,+FAA+F;IAC/F,QAAQ,CAAC,SAAS,EAAE,cAAc,aAAa,EAAE,SAAS,CAAA;IAC1D,yEAAyE;IACzE,QAAQ,CAAC,YAAY,EAAE,cAAc,aAAa,EAAE,YAAY,CAAA;IAChE,4FAA4F;IAC5F,QAAQ,CAAC,iBAAiB,EAAE,cAAc,aAAa,EAAE,iBAAiB,CAAA;IAC1E,2FAA2F;IAC3F,QAAQ,CAAC,eAAe,EAAE,cAAc,aAAa,EAAE,eAAe,CAAA;IACtE,yFAAyF;IACzF,QAAQ,CAAC,qBAAqB,EAAE,cAAc,aAAa,EAAE,qBAAqB,CAAA;IAClF,8FAA8F;IAC9F,QAAQ,CAAC,oBAAoB,EAAE,cAAc,aAAa,EAAE,oBAAoB,CAAA;IAChF,6EAA6E;IAC7E,QAAQ,CAAC,iBAAiB,EAAE,cAAc,aAAa,EAAE,iBAAiB,CAAA;IAC1E,6DAA6D;IAC7D,QAAQ,CAAC,mBAAmB,EAAE,cAAc,aAAa,EAAE,mBAAmB,CAAA;IAC9E,2EAA2E;IAC3E,QAAQ,CAAC,oBAAoB,EAAE,cAAc,aAAa,EAAE,oBAAoB,CAAA;IAChF,kEAAkE;IAClE,QAAQ,CAAC,SAAS,EAAE,cAAc,aAAa,EAAE,SAAS,CAAA;IAC1D,8FAA8F;IAC9F,QAAQ,CAAC,cAAc,EAAE,cAAc,aAAa,EAAE,cAAc,CAAA;IAGpE,6DAA6D;IAC7D,QAAQ,CAAC,WAAW,EAAE,cAAc,uBAAuB,EAAE,WAAW,CAAA;IACxE,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE,cAAc,iBAAiB,EAAE,UAAU,CAAA;IAChE,6BAA6B;IAC7B,QAAQ,CAAC,cAAc,EAAE,cAAc,iBAAiB,EAAE,cAAc,CAAA;IACxE,8BAA8B;IAC9B,QAAQ,CAAC,eAAe,EAAE,cAAc,iBAAiB,EAAE,eAAe,CAAA;IAC1E,8GAA8G;IAC9G,QAAQ,CAAC,eAAe,EAAE,cAAc,iBAAiB,EAAE,eAAe,CAAA;IAC1E,mEAAmE;IACnE,QAAQ,CAAC,UAAU,EAAE,cAAc,iBAAiB,EAAE,UAAU,CAAA;IAChE,mFAAmF;IACnF,QAAQ,CAAC,cAAc,EAAE,cAAc,qBAAqB,EAAE,cAAc,CAAA;IAC5E,qEAAqE;IACrE,QAAQ,CAAC,cAAc,EAAE,cAAc,qBAAqB,EAAE,cAAc,CAAA;IAG5E,8CAA8C;IAC9C,QAAQ,CAAC,iBAAiB,EAAE,cAAc,kBAAkB,EAAE,iBAAiB,CAAA;IAC/E,6EAA6E;IAC7E,QAAQ,CAAC,cAAc,EAAE,cAAc,aAAa,EAAE,cAAc,CAAA;IACpE,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,cAAc,aAAa,EAAE,QAAQ,CAAA;IACxD,2CAA2C;IAC3C,QAAQ,CAAC,qBAAqB,EAAE,cAAc,wBAAwB,EAAE,qBAAqB,CAAA;IAC7F,oCAAoC;IACpC,QAAQ,CAAC,mBAAmB,EAAE,cAAc,wBAAwB,EAAE,mBAAmB,CAAA;IACzF,wCAAwC;IACxC,QAAQ,CAAC,kBAAkB,EAAE,cAAc,sBAAsB,EAAE,kBAAkB,CAAA;IACrF,iCAAiC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,cAAc,sBAAsB,EAAE,gBAAgB,CAAA;CAClF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;IACrC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAA;IACvC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAA;IACzC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAA;IACnC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;IACrC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAA;IACvC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAA;IAC3C,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;IACrC,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAA;IAC7C,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAA;IAC/C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAA;IACzC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAA;IACnC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;IACrC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAA;IACvC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;IACrC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAA;IACzC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAA;IACzC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAA;IACzC,QAAQ,CAAC,oBAAoB,EAAE,oBAAoB,CAAA;IACnD,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAA;IACzC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,uBAAuB,EAAE,uBAAuB,CAAA;IACzD,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAA;IAC/C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAA;IACvC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAA;IAC3C,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;IACrC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAA;IACvC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAA;IACnC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;IACrC,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAA;IAC7C,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAA;IACnC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAA;IACnC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAA;IACnC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAA;IAC3C,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAA;IACjD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;IACrC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAA;IAC3C,QAAQ,CAAC,oBAAoB,EAAE,oBAAoB,CAAA;CACpD;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;CAAG;AAE/D;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB;IAEhC,WAAW,EAAE,WAAW,CAAA;IACxB,iBAAiB,EAAE,iBAAiB,CAAA;IACpC,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,cAAc,EAAE,cAAc,CAAA;IAC9B,aAAa,EAAE,aAAa,CAAA;IAE5B,SAAS,EAAE,SAAS,CAAA;IACpB,KAAK,EAAE,KAAK,CAAA;IACZ,WAAW,EAAE,WAAW,CAAA;IACxB,UAAU,EAAE,UAAU,CAAA;IACtB,aAAa,EAAE,aAAa,CAAA;IAC5B,cAAc,EAAE,cAAc,CAAA;IAC9B,eAAe,EAAE,eAAe,CAAA;IAChC,UAAU,EAAE,UAAU,CAAA;IACtB,IAAI,EAAE,IAAI,CAAA;IACV,QAAQ,EAAE,QAAQ,CAAA;IAClB,YAAY,EAAE,YAAY,CAAA;IAC1B,SAAS,EAAE,SAAS,CAAA;IACpB,IAAI,EAAE,IAAI,CAAA;IACV,UAAU,EAAE,UAAU,CAAA;IACtB,SAAS,EAAE,SAAS,CAAA;IACpB,WAAW,EAAE,WAAW,CAAA;IACxB,WAAW,EAAE,WAAW,CAAA;IACxB,aAAa,EAAE,aAAa,CAAA;IAC5B,QAAQ,EAAE,QAAQ,CAAA;IAClB,eAAe,EAAE,eAAe,CAAA;IAChC,YAAY,EAAE,YAAY,CAAA;IAC1B,cAAc,EAAE,cAAc,CAAA;IAC9B,WAAW,EAAE,WAAW,CAAA;IACxB,aAAa,EAAE,aAAa,CAAA;IAC5B,aAAa,EAAE,aAAa,CAAA;IAC5B,eAAe,EAAE,eAAe,CAAA;IAChC,eAAe,EAAE,eAAe,CAAA;IAChC,eAAe,EAAE,eAAe,CAAA;IAChC,oBAAoB,EAAE,oBAAoB,CAAA;IAC1C,eAAe,EAAE,eAAe,CAAA;IAChC,WAAW,EAAE,WAAW,CAAA;IACxB,uBAAuB,EAAE,uBAAuB,CAAA;IAChD,kBAAkB,EAAE,kBAAkB,CAAA;IACtC,WAAW,EAAE,WAAW,CAAA;IACxB,WAAW,EAAE,WAAW,CAAA;IACxB,WAAW,EAAE,WAAW,CAAA;IACxB,YAAY,EAAE,YAAY,CAAA;IAC1B,QAAQ,EAAE,QAAQ,CAAA;IAClB,cAAc,EAAE,cAAc,CAAA;IAC9B,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,cAAc,EAAE,cAAc,CAAA;IAC9B,aAAa,EAAE,aAAa,CAAA;IAC5B,OAAO,EAAE,OAAO,CAAA;IAEhB,aAAa,EAAE,aAAa,CAAA;IAC5B,cAAc,EAAE,cAAc,CAAA;IAC9B,UAAU,EAAE,UAAU,CAAA;IACtB,YAAY,EAAE,YAAY,CAAA;IAC1B,iBAAiB,EAAE,iBAAiB,CAAA;IACpC,UAAU,EAAE,UAAU,CAAA;IACtB,aAAa,EAAE,aAAa,CAAA;IAC5B,YAAY,EAAE,YAAY,CAAA;IAC1B,eAAe,EAAE,eAAe,CAAA;IAChC,YAAY,EAAE,YAAY,CAAA;IAE1B,aAAa,EAAE,aAAa,CAAA;IAC5B,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,cAAc,EAAE,cAAc,CAAA;IAC9B,aAAa,EAAE,aAAa,CAAA;IAC5B,iBAAiB,EAAE,iBAAiB,CAAA;IACpC,kBAAkB,EAAE,kBAAkB,CAAA;IAEtC,oBAAoB,EAAE,oBAAoB,CAAA;IAC1C,gBAAgB,EAAE,gBAAgB,CAAA;CACnC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,66BAiD0B,CAAA;AAErD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,m9BA0D+B,CAAA;AAEzD;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,i9BAI0B,CAAA;AAErD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,m9BAA6E,CAAA;AAEvG;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,kWAmBsB,CAAA;AAErD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,0nBAiC0B,CAAA;AAErD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,4NAc4B,CAAA;AAEzD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,qFAK2B,CAAA;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,0lCAmE+B,CAAA"}
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../src/interface.ts"],"names":[],"mappings":"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"}

package/dist/interface.js

@@ -1,19 +1,22 @@
 /**
  * The integer interface generation this module implements.
  *
- * `3` is the CURRENT generation: the v2 surface MINUS the 18 zero-consumer members that moved to
- * `./internal` (INTERFACE.md §9) and PLUS the one newly-named compat type (`ServiceContract`). The
+ * `4` is the CURRENT generation: the v3 NAME surface UNCHANGED, with one member's accepted input
+ * widened — `verifyRegisteredFaces` now takes an optional, opaque `scope` and hands it to
+ * `tools.get(name, scope)` (INTERFACE.md §10). Nothing was added to or removed from `.`; what moved is
+ * what an existing member accepts, which is an interface change all the same (INTERFACE.md §1). The
  * file name's `N` and this constant are the SAME fact — `test/public-surface.spec.ts` asserts that the
  * snapshot for this constant exists and that its `interfaceVersion` field equals it, so "the JSON says
- * v4, the constant says 3" cannot happen. Bump it (and add `api/interface-vN.json`) only for an
+ * v5, the constant says 4" cannot happen. Bump it (and add `api/interface-vN.json`) only for an
  * interface change (INTERFACE.md §1); a behaviour change or a fix does NOT touch it. The plugins bake
  * this number into their artifacts and compare it, at startup, with the number the base they loaded
  * reports — a difference is a warning and a capability-level degradation, never a refused mount.
  *
- * `2` and `1` are the earlier frozen generations (`api/interface-v2.json`, `api/interface-v1.json`).
- * They stay in the tree as those generations' records and as the types the plugins still import.
+ * `3`, `2` and `1` are the earlier frozen generations (`api/interface-v3.json`,
+ * `api/interface-v2.json`, `api/interface-v1.json`). They stay in the tree as those generations'
+ * records and as the types callers compiled against still import.
  */
-export const INTERFACE_VERSION = 3;
+export const INTERFACE_VERSION = 4;
 /**
  * Every VALUE name of the v1 `.` surface, in {@link BaseRuntimeV1} declaration order.
  *
@@ -160,9 +163,9 @@ export const TYPE_NAMES_V2 = [...TYPE_NAMES_V1];
 /**
  * The VALUE names v3 shed from `.` — the frozen PRUNE list (INTERFACE.md §9).
  *
- * Every one of them has zero consumers across the two plugin trees' non-test source and scripts (the
- * proof is `PUBLIC-SURFACE`'s cross-tree check), and every one of them now lives on `./internal`
- * instead. This list is not documentation: `test/public-surface.spec.ts` asserts
+ * Every one of them has zero consumers across the discovered consumer trees' non-test source and
+ * scripts (the proof is `PUBLIC-SURFACE`'s cross-tree check), and every one of them now lives on
+ * `./internal` instead. This list is not documentation: `test/public-surface.spec.ts` asserts
  * `VALUE_NAMES_V2 === [...VALUE_NAMES_V3, ...PRUNED_VALUE_NAMES]` (both directions), so a v4 cannot
  * quietly drop a name that is neither in the surface nor on this list.
  */
@@ -187,11 +190,12 @@ export const PRUNED_VALUE_NAMES = [
     'strictCodec',
 ];
 /**
- * Every VALUE name of the CURRENT (v3) `.` surface, in {@link BaseRuntimeV3} declaration order.
+ * Every VALUE name of the FROZEN v3 `.` surface, in {@link BaseRuntimeV3} declaration order.
  *
  * NOT a spread of v2: v3 prunes, so it is stated as itself. The `satisfies` clause ties it to
  * {@link BaseRuntimeV3}, and the gate asserts the whole `keyof`, so a member added to the interface
- * and not to this list is a compile error.
+ * and not to this list is a compile error. v3 stays frozen as that generation's record;
+ * {@link VALUE_NAMES_V4} is the current list, exactly this one.
  */
 export const VALUE_NAMES_V3 = [
     'INTERFACE_VERSION',
@@ -227,6 +231,16 @@ export const VALUE_NAMES_V3 = [
     'modelCacheProvider',
     'MODEL_CACHE_KIND',
 ];
+/**
+ * Every VALUE name of the CURRENT (v4) `.` surface, in {@link BaseRuntimeV4} declaration order.
+ *
+ * The spread is the whole point of this generation: v4 adds no name, so the list is stated as "the v3
+ * list verbatim" and `test/public-surface.spec.ts` asserts equality with {@link VALUE_NAMES_V3} — both
+ * the set and the order, so neither half of that claim can drift silently. The `satisfies` clause
+ * still checks the whole v4 `keyof`, so a member added to {@link BaseRuntimeV4} and not here is a
+ * compile error.
+ */
+export const VALUE_NAMES_V4 = [...VALUE_NAMES_V3];
 /**
  * The TYPE names v3 NAMES for the first time — they were reachable through `export *` in v2 but were
  * never declared in {@link BaseTypeSurfaceV2}, so they had no entry and no promise. v3's explicit
@@ -258,10 +272,11 @@ export const PRUNED_TYPE_NAMES = [
     'StrictCodec',
 ];
 /**
- * Every TYPE name of the CURRENT (v3) `.` surface, in {@link BaseTypeSurfaceV3} declaration order.
+ * Every TYPE name of the FROZEN v3 `.` surface, in {@link BaseTypeSurfaceV3} declaration order.
  *
  * v3 is a pruning generation, so this is stated explicitly rather than spread. The gate asserts it
- * partitions v2 together with {@link PRUNED_TYPE_NAMES} and {@link ADDED_TYPE_NAMES}.
+ * partitions v2 together with {@link PRUNED_TYPE_NAMES} and {@link ADDED_TYPE_NAMES}. v3 stays frozen
+ * as that generation's record; {@link TYPE_NAMES_V4} is the current list, exactly this one.
  */
 export const TYPE_NAMES_V3 = [
     'ArchivePack',
@@ -331,4 +346,12 @@ export const TYPE_NAMES_V3 = [
     'InterfaceRequirement',
     'InterfaceVerdict',
 ];
+/**
+ * Every TYPE name of the CURRENT (v4) `.` surface, in {@link BaseTypeSurfaceV4} declaration order.
+ *
+ * Like {@link VALUE_NAMES_V4}, the spread states the fact this generation is about: v4 names no new type
+ * and sheds none, so the list is the v3 list verbatim. `test/public-surface.spec.ts` asserts equality
+ * with {@link TYPE_NAMES_V3}, and the `satisfies` clause ties it to the whole v4 `keyof`.
+ */
+export const TYPE_NAMES_V4 = [...TYPE_NAMES_V3];
 //# sourceMappingURL=interface.js.map

package/dist/interface_gate.d.ts

@@ -15,7 +15,8 @@ export interface InterfaceRequirement {
  *
  * `ok` — both sides were readable and the loaded base can serve this build: either the generations are
  * equal, or the loaded base is NEWER and the newer generation provably keeps every member a consumer
- * uses (the additive superset for v1 → v2; the pruning proof for v2 → v3).
+ * uses (the additive superset for v1 → v2; the pruning proof for v2 → v3, inherited unchanged by the
+ * name-preserving v3 → v4).
  * Use the base normally; if {@link InterfaceVerdict.warning} is set, log it as one WARNING first.
  * `incompatible` — both sides were readable and the loaded base is OLDER than the build, so the members
  * this build requires may be missing; a caller must NOT use the base's shared capabilities. The family

package/dist/interface_gate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interface_gate.d.ts","sourceRoot":"","sources":["../src/interface_gate.ts"],"names":[],"mappings":"AA6CA;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,qFAAqF;IACrF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;CAClC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,cAAc,GAAG,aAAa,CAAA;IACtD,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE;IAAE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/C,gBAAgB,CA2ClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAa5F"}
+{"version":3,"file":"interface_gate.d.ts","sourceRoot":"","sources":["../src/interface_gate.ts"],"names":[],"mappings":"AAiDA;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,qFAAqF;IACrF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;CAClC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,cAAc,GAAG,aAAa,CAAA;IACtD,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE;IAAE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/C,gBAAgB,CA+ClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAa5F"}

package/dist/interface_gate.js

@@ -32,8 +32,12 @@
  *  - an ADDITIVE generation states `Vn extends Vn-1` and the snapshot gate checks the name superset
  *    (`v1 → v2`, INTERFACE.md §5);
  *  - a PRUNING generation (`v2 → v3`, INTERFACE.md §9) instead proves `Vn-1 = Vn ⊎ PRUNED` plus that
- *    every `PRUNED` name has zero consumers across the two plugin trees
- *    (`test/public-surface.spec.ts`), and `test/interface_gate.spec.ts` pins it against the real module.
+ *    every `PRUNED` name has zero consumers across every discovered plugin tree
+ *    (`test/public-surface.spec.ts`), and `test/interface_gate.spec.ts` pins it against the real module;
+ *  - a generation that changes NO NAME (`v3 → v4`, INTERFACE.md §10) inherits the previous generation's
+ *    proof as-is — it only WIDENS what an existing member accepts (an optional input field), so the v3
+ *    prune proof still carries the rule and the name lists are asserted equal in
+ *    `test/public-surface.spec.ts`.
  *
  * The `loaded > required` branch below is admissible ONLY while one of those proofs holds. A generation
  * that drops a name WITH a consumer would fail the pruning proof, and that is the signal it must not be
@@ -83,14 +87,18 @@ export function checkInterface(required, module) {
     if (loadedVersion === required)
         return { status: 'ok', required, loaded: loadedVersion };
     if (loadedVersion > required) {
-        // The SAFE direction, admitted only on the mechanical superset proof (see the module header):
-        // every member this older build requires still exists, so the base is used normally — the newer
-        // generation's OWN members simply go unused by this build.
+        // The SAFE direction, admitted only on the mechanical proof (see the module header): every member
+        // this older build requires still exists, so the base is used normally — the newer generation's
+        // OWN members simply go unused by this build. The sentence below deliberately does NOT say
+        // "generations are pure additions": that was never true in general (v3 PRUNED 18 members), and a
+        // maintainer reading it that way could treat a pruning generation as admissible. What is true —
+        // and what the proof establishes per generation — is the weaker, checkable claim: the members
+        // THIS build requires were not taken away.
         return {
             status: 'ok',
             required,
             loaded: loadedVersion,
-            warning: `the loaded base reports interface generation ${String(loadedVersion)}, newer than the ${String(required)} this build was written for (host base is newer); WARNING — generations are pure additions, so every member this build requires is present and the base is judged usable`,
+            warning: `the loaded base reports interface generation ${String(loadedVersion)}, newer than the ${String(required)} this build was written for (host base is newer); WARNING — the newer generation keeps every member this build requires (that is the proof it is admitted on: an additive superset, or a pruning whose shed names are frozen and have zero consumers), so the base is judged usable`,
         };
     }
     return {

package/dist/internal.d.ts

@@ -7,8 +7,8 @@
  *  - the framework's own seams (fs, locks, archives, layout, lint, semver …), and
  *  - the **composition pieces** of the pieces `.` does export: the individual probes and evidence
  *    helpers `compat.gatherEvidence` is built from, the provisioner's policy helpers and constants,
- *    the npm-package provider, and the Typert symbol kit whose symbols/wire helpers the two plugins
- *    keep as LOCAL mirrors by design (they are assembled at module load, before any base can be
+ *    the npm-package provider, and the Typert symbol kit whose symbols/wire helpers every plugin
+ *    keeps as a LOCAL mirror by design (they are assembled at module load, before any base can be
  *    imported).
  *
  * Generation v3 moved exactly those zero-consumer names here (INTERFACE.md §9). `./internal` is NOT