@almadar/core 10.129.0 → 11.0.0

package/dist/behavior-package.d.ts

@@ -5,7 +5,7 @@ declare const BehaviorPackageOrbBlockSchema: z.ZodObject<{
     registry: z.ZodOptional<z.ZodString>;
     source: z.ZodOptional<z.ZodString>;
     vectors: z.ZodOptional<z.ZodString>;
-    compiler: z.ZodString;
+    language: z.ZodString;
 }, z.core.$strip>;
 type BehaviorPackageOrbBlock = z.infer<typeof BehaviorPackageOrbBlockSchema>;
 /** `sidecars.lock.json` — package-relative paths whose content lives in the sidecar store (§13). */
@@ -66,13 +66,18 @@ declare function userStoreDir(): string;
  * across rungs (callers keep the nearest).
  */
 declare function installedPackageDirs(startDir: string, userStore?: string): string[];
+interface DiscoverOptions {
+    /** The `orb` binary; default {@link resolveOrbBinary} from `startDir`. */
+    orbBin?: string;
+    /** The home whose `.orb` is the user store (the last rung); default the process's. */
+    home?: string;
+}
 /**
- * Every installed behavior package, the same rule as `orb`
- * (`orbital-core` `behavior_packages::discover`): every package
- * ({@link installedPackageDirs}) whose `package.json` carries a behavior `orb`
- * block; nearest wins per name; two packages claiming one prefix is an error.
+ * Every installed behavior package, as `orb` discovers them (`orbital-core` `behavior_packages::discover`, the std
+ * `orb list --json --ancestors` command): each ancestor `node_modules` of `startDir`, nearest first, then the user
+ * store's; nearest wins per name; two packages claiming one prefix is an error.
  */
-declare function discoverBehaviorPackages(startDir: string, userStore?: string): BehaviorPackage[];
+declare function discoverBehaviorPackages(startDir: string, options?: DiscoverOptions): BehaviorPackage[];
 /** Resolve an installed behavior package by name, node-style, from `fromDir`. */
 declare function findInstalledBehaviorPackage(name: string, fromDir: string): BehaviorPackage;
 /** The absolute path of a file (or the registry directory) the package declares. Fails when it is missing. */
@@ -88,14 +93,14 @@ declare function derivedCacheDir(): string;
 interface RegistryDirOptions {
     orbBin?: string;
     cacheDir?: string;
-    /** How many files one `orb lower` run takes. */
-    batch?: number;
 }
 /**
  * Delete every live-package mirror under the derived cache except those of
  * `keep` (as the current `orb` keys them) — a new `orb` binary, new language data or a moved
  * checkout leaves the old ones behind. Returns the removed directories.
- * Explicit only: other checkouts share the cache, so nothing prunes on its own.
+ * Explicit and total: it removes every mirror not in `keep`. Reading a mirror
+ * ({@link behaviorRegistryDir}) separately keeps only the newest
+ * {@link REGISTRY_MIRROR_LIMIT}.
  */
 declare function pruneRegistryMirrors(keep: readonly BehaviorPackage[], options?: RegistryDirOptions): string[];
 /**
@@ -109,6 +114,19 @@ declare function pruneRegistryMirrors(keep: readonly BehaviorPackage[], options?
  * so every reader of `.orb` files works unchanged. A lowering error fails the call,
  * naming the file.
  */
+/**
+ * How many live-package mirrors the derived cache keeps. One mirror is a package's full lowered registry
+ * (170-360 MB for std), keyed by package root, `orb` binary and language data, so every rebuilt `orb` and every
+ * checkout adds one per package. Six holds the current and the previous binary of the two packages a checkout
+ * mounts (std, behaviors) plus a second checkout's current pair, and bounds the cache near 2 GB.
+ */
+declare const REGISTRY_MIRROR_LIMIT = 6;
+/**
+ * Evict the mirrors under `registryRoot` beyond the `limit` most recently used (directory modification time,
+ * newest first, ties broken by name), always keeping every directory in `protectedDirs`. Returns the removed
+ * directories, sorted.
+ */
+declare function evictOldMirrors(registryRoot: string, protectedDirs: ReadonlySet<string>, limit?: number): string[];
 /**
  * The files a package authors its behaviors in, without lowering anything: a
  * live package's `.lolo` source tree, or a published package's declared registry
@@ -119,7 +137,27 @@ declare function behaviorSourceTree(pkg: BehaviorPackage): {
     dir: string;
     extension: '.lolo' | '.orb';
 };
+declare const MaterializeAnswerSchema: z.ZodObject<{
+    dir: z.ZodString;
+    failures: z.ZodArray<z.ZodObject<{
+        rel: z.ZodString;
+        error: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type MaterializeFailure = z.infer<typeof MaterializeAnswerSchema>['failures'][number];
+interface BehaviorRegistry {
+    dir: string;
+    /** Sources that did not lower; the rest of the mirror is current. Empty for a materialized registry. */
+    failures: MaterializeFailure[];
+}
+/** The registry mirror's directory; use {@link behaviorRegistry} to see which sources failed to lower. */
 declare function behaviorRegistryDir(pkg: BehaviorPackage, options?: RegistryDirOptions): string;
+/**
+ * Throws naming the file and its lower error when `rel` (a `.lolo` path relative to the source tree, or its `.orb`
+ * twin) is one of the registry's failures.
+ */
+declare function assertImportable(pkg: BehaviorPackage, registry: BehaviorRegistry, rel: string): void;
+declare function behaviorRegistry(pkg: BehaviorPackage, options?: RegistryDirOptions): BehaviorRegistry;
 /**
  * Every behavior program in the package's registry, by behavior name: each `.orb` under the
  * registry tree, named by its basename (the rule `orb` indexes by). Two programs with one name
@@ -142,5 +180,5 @@ interface MaterializeOptions extends RegistryDirOptions {
  */
 declare function materializeRegistry(pkg: BehaviorPackage, options?: MaterializeOptions): BehaviorPackageOrbBlock;
 
-export { BUILD_INPUTS_LOCK_FILE, BehaviorPackageError, BehaviorPackageOrbBlockSchema, SIDECAR_LOCK_FILE, SidecarLockSchema, behaviorProgramFiles, behaviorRegistryDir, behaviorSourceTree, derivedCacheDir, discoverBehaviorPackages, ensureDeclaredPath, ensureLockEntry, findInstalledBehaviorPackage, installedPackageDirs, materializeRegistry, pruneRegistryMirrors, readBehaviorPackage, readLockFile, resolveDeclaredFile, resolveDeclaredPath, resolveOrbBinary, sidecarCacheDir, userStoreDir };
-export type { BehaviorPackage, BehaviorPackageOrbBlock, DeclaredFileKey, MaterializeOptions, RegistryDirOptions, SidecarFetch, SidecarLock, SidecarLockEntry, SidecarOptions };
+export { BUILD_INPUTS_LOCK_FILE, BehaviorPackageError, BehaviorPackageOrbBlockSchema, MaterializeAnswerSchema, REGISTRY_MIRROR_LIMIT, SIDECAR_LOCK_FILE, SidecarLockSchema, assertImportable, behaviorProgramFiles, behaviorRegistry, behaviorRegistryDir, behaviorSourceTree, derivedCacheDir, discoverBehaviorPackages, ensureDeclaredPath, ensureLockEntry, evictOldMirrors, findInstalledBehaviorPackage, installedPackageDirs, materializeRegistry, pruneRegistryMirrors, readBehaviorPackage, readLockFile, resolveDeclaredFile, resolveDeclaredPath, resolveOrbBinary, sidecarCacheDir, userStoreDir };
+export type { BehaviorPackage, BehaviorPackageOrbBlock, BehaviorRegistry, DeclaredFileKey, DiscoverOptions, MaterializeFailure, MaterializeOptions, RegistryDirOptions, SidecarFetch, SidecarLock, SidecarLockEntry, SidecarOptions };

package/dist/behavior-package.js

@@ -1,3 +1,3 @@
-export { BUILD_INPUTS_LOCK_FILE, BehaviorPackageError, BehaviorPackageOrbBlockSchema, SIDECAR_LOCK_FILE, SidecarLockSchema, behaviorProgramFiles, behaviorRegistryDir, behaviorSourceTree, derivedCacheDir, discoverBehaviorPackages, ensureDeclaredPath, ensureLockEntry, findInstalledBehaviorPackage, installedPackageDirs, materializeRegistry, pruneRegistryMirrors, readBehaviorPackage, readLockFile, resolveDeclaredFile, resolveDeclaredPath, resolveOrbBinary, sidecarCacheDir, userStoreDir } from './chunk-X4SC7FGF.js';
+export { BUILD_INPUTS_LOCK_FILE, BehaviorPackageError, BehaviorPackageOrbBlockSchema, MaterializeAnswerSchema, REGISTRY_MIRROR_LIMIT, SIDECAR_LOCK_FILE, SidecarLockSchema, assertImportable, behaviorProgramFiles, behaviorRegistry, behaviorRegistryDir, behaviorSourceTree, derivedCacheDir, discoverBehaviorPackages, ensureDeclaredPath, ensureLockEntry, evictOldMirrors, findInstalledBehaviorPackage, installedPackageDirs, materializeRegistry, pruneRegistryMirrors, readBehaviorPackage, readLockFile, resolveDeclaredFile, resolveDeclaredPath, resolveOrbBinary, sidecarCacheDir, userStoreDir } from './chunk-RGACZEYC.js';
 //# sourceMappingURL=behavior-package.js.map
 //# sourceMappingURL=behavior-package.js.map