@omnitron-dev/omnitron 0.3.0 → 0.3.2

package/dist/orchestrator/app-handle.d.ts

@@ -4,11 +4,13 @@
  * Stores the PM supervisor (bootstrap mode) or raw ChildProcess (classic mode)
  * along with app-level metadata.
  */
+import { RestartWindow } from '@omnitron-dev/titan-pm';
 import type { ChildProcess } from 'node:child_process';
 import type { IProcessMetrics, IHealthStatus, IProcessPool } from '@omnitron-dev/titan-pm';
 import type { ProcessSupervisor } from '@omnitron-dev/titan-pm';
-import type { AppStatus, IEcosystemAppEntry, IProcessEntry } from '../config/types.js';
-import type { ServiceRouter } from './service-router.js';
+import type { AppStatus, IEcosystemAppEntry, IProcessEntry, RuntimeReleaseEvidence } from '../config/types.js';
+import type { ApplicationTopology } from './application-topology.js';
+import type { BootstrapMetadata } from '../project/bootstrap-metadata.js';
 /**
  * Last-known exit context retained on the AppHandle after a child
  * dies. Pre-fix nothing about a crashed app was preserved past the
@@ -40,6 +42,11 @@ export interface LastExitInfo {
 }
 export declare class AppHandle {
     readonly mode: 'classic' | 'bootstrap';
+    readonly generation: `${string}-${string}-${string}-${string}-${string}`;
+    /** Captured for this launch; changing the next-start definition never rewrites it. */
+    release: RuntimeReleaseEvidence;
+    invalidateRelease(): void;
+    bootstrapMetadata: BootstrapMetadata | null;
     pid: number | null;
     status: AppStatus;
     startedAt: number;
@@ -73,14 +80,16 @@ export declare class AppHandle {
         memory: number;
     }>;
     lastHealth: IHealthStatus | null;
+    /** Identity of this classic launch, also propagated to its heartbeat writer. */
+    healthRunId: string | undefined;
     /** PM supervisor managing this app's processes (bootstrap mode) */
     supervisor: ProcessSupervisor | null;
     /** The raw child_process.ChildProcess (classic mode only) */
     childProcess: ChildProcess | null;
     /** Instance count for scaling */
     instanceCount: number;
-    /** Netron-native service router for topology */
-    serviceRouter: ServiceRouter | null;
+    /** Native Netron listener and services owned by this application launch. */
+    topology: ApplicationTopology | null;
     /**
      * The app's own `logger.level`, read from its `config/default.json`.
      *
@@ -106,8 +115,6 @@ export declare class AppHandle {
      * have N live workers).
      */
     topologyPools: Map<string, IProcessPool<unknown>>;
-    /** Timer for classic-mode crash restart backoff (cleared on explicit stop) */
-    crashRestartTimer: ReturnType<typeof setTimeout> | null;
     /** Stdout/stderr log buffer (ring buffer) */
     private logBuffer;
     private readonly maxLogLines;
@@ -123,6 +130,8 @@ export declare class AppHandle {
      * a successful start and the next exit. Set by `recordExit()`.
      */
     lastExit: LastExitInfo | null;
+    /** Sliding recovery budget; lifetime restarts remain a separate diagnostic. */
+    restartWindow: RestartWindow;
     private definition;
     constructor(entry: IEcosystemAppEntry, mode: 'classic' | 'bootstrap');
     /**
@@ -131,13 +140,17 @@ export declare class AppHandle {
      * started with; `restartAppNow` starts from this.
      */
     get entry(): IEcosystemAppEntry;
+    /** Redefinition revokes lifecycle work admitted against an earlier definition,
+     * even when an operator later restores the same entry object. */
+    private nextDefinitionRevision;
+    get definitionRevision(): number;
     /**
      * Take a new definition for the next start.
      *
      * The handle captured its entry once, at the first start, and every restart
      * reused it — so a deployment that rewrote an app's environment and then
-     * restarted it restarted it on the old one. Measured on daos/test,
-     * 2026-09-23: paysys came back pointed at the chain's old address after a
+     * restarted it restarted it on the old one. Measured on sample/test,
+     * 2026-09-23: payments came back pointed at the chain's old address after a
      * deployment had written the new one to the node.
      *
      * Refused for another name: a handle is keyed by its app's name, and a
@@ -179,7 +192,7 @@ export declare class AppHandle {
      * A bootstrap app used to take every child's start as its own: each
      * `child:started` called `markOnline(childPid)`, so the app was `online`
      * from its FIRST child, and its pid was that of its LAST. Measured on
-     * daos/dev/main: pid 58130, the notification-worker, while port 3001 was
+     * sample/dev/main: pid 58130, the notification-worker, while port 3001 was
      * held by the http process, 57952 — four of six apps the same way. That
      * pid is what `list` prints, what the console calls «the app's PID», what
      * `inspect` measured (181.9 MB of the app's 661.8 MB), and what the ghost
@@ -194,6 +207,10 @@ export declare class AppHandle {
     private declaredChildren;
     private serverChild;
     private readonly startedChildren;
+    private startupPending;
+    /** Process readiness alone cannot admit an unfinished topology. */
+    deferStartup(): void;
+    finishStartup(): boolean;
     declareChildren(children: readonly string[], serverChild: string | null): void;
     /**
      * One declared child is up. The server child's pid becomes the app's.
@@ -204,6 +221,7 @@ export declare class AppHandle {
      * still down), because a partial app is not an online one.
      */
     childStarted(child: string, pid: number | null): boolean;
+    private updateOnline;
     /**
      * One declared child is down — crashed, or stopped. The app is no longer
      * whole, and if it was the server, the app has no pid until it is back:

package/dist/orchestrator/app-handle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-handle.d.ts","sourceRoot":"","sources":["../../src/orchestrator/app-handle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,+DAA+D;IAC/D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,kEAAkE;IAClE,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,SAAS;aAsGF,IAAI,EAAE,SAAS,GAAG,WAAW;IArGxC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC1B,MAAM,EAAE,SAAS,CAAa;IAC9B,SAAS,EAAE,MAAM,CAAK;IACtB,QAAQ,EAAE,MAAM,CAAK;IAC5B;;;;;;;;;;;;;OAaG;IACH,IAAI,IAAI,IAAI,MAAM,GAAG,IAAI,CAGxB;IACM,WAAW,EAAE,eAAe,GAAG,IAAI,CAAQ;IAElD;;;;;;;OAOG;IACI,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAa;IAEvE,UAAU,EAAE,aAAa,GAAG,IAAI,CAAQ;IAE/C,mEAAmE;IAC5D,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAQ;IAEnD,6DAA6D;IACtD,YAAY,EAAE,YAAY,GAAG,IAAI,CAAQ;IAEhD,iCAAiC;IAC1B,aAAa,EAAE,MAAM,CAAK;IAEjC,gDAAgD;IACzC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAQ;IAElD;;;;;;;;;OASG;IACI,WAAW,EAAE,CAAC,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC,GAAG,SAAS,CAAC;IAErG,mDAAmD;IAC5C,iBAAiB,EAAE,aAAa,EAAE,GAAG,IAAI,CAAQ;IAExD;;;;;;;;;;OAUG;IACI,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAa;IAErE,8EAA8E;IACvE,iBAAiB,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAQ;IAEtE,6CAA6C;IAC7C,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IAEpC;;;;OAIG;IACH,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAM;IAErC;;;OAGG;IACI,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAQ;IAE5C,OAAO,CAAC,UAAU,CAAqB;IAEvC,YACE,KAAK,EAAE,kBAAkB,EACT,IAAI,EAAE,SAAS,GAAG,WAAW,EAG9C;IAED;;;;OAIG;IACH,IAAI,KAAK,IAAI,kBAAkB,CAE9B;IAED;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAKxC;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,MAAM,IAAI,MAAM,CAGnB;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAK5B;IAED;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAK/B;IAED,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAGhC;IAED;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE;QACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;QACvC,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,IAAI,CASP;IAED,yEAAyE;IACzE,aAAa,IAAI,IAAI,CAGpB;IAED,YAAY,IAAI,IAAI,CAGnB;IAED,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAG5B;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,gBAAgB,CAAyB;IACjD,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IAErD,eAAe,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAK7E;IAED;;;;;;;OAOG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAMvD;IAED;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAG7B;IAED,YAAY,IAAI,IAAI,CAEnB;IAED,WAAW,IAAI,IAAI,CASlB;IAED,WAAW,IAAI,IAAI,CAElB;IAED,WAAW,IAAI,IAAI,CAGlB;CACF"}
+{"version":3,"file":"app-handle.d.ts","sourceRoot":"","sources":["../../src/orchestrator/app-handle.ts"],"names":[],"mappings":"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"}

package/dist/orchestrator/app-handle.js

@@ -4,8 +4,19 @@
  * Stores the PM supervisor (bootstrap mode) or raw ChildProcess (classic mode)
  * along with app-level metadata.
  */
+import { randomUUID } from 'node:crypto';
+import { RestartWindow } from '@omnitron-dev/titan-pm';
 export class AppHandle {
     mode;
+    generation = randomUUID();
+    /** Captured for this launch; changing the next-start definition never rewrites it. */
+    release = { state: 'unreported', reason: 'No verified release receipt was captured for this launch.' };
+    invalidateRelease() {
+        if (this.release.state === 'confirmed')
+            this.release = { state: 'unreported', releaseId: this.release.releaseId,
+                reason: 'Application process membership changed after its verified launch; a fresh launch verification is required.' };
+    }
+    bootstrapMetadata = null;
     pid = null;
     status = 'stopped';
     startedAt = 0;
@@ -39,14 +50,16 @@ export class AppHandle {
      */
     childMetrics = new Map();
     lastHealth = null;
+    /** Identity of this classic launch, also propagated to its heartbeat writer. */
+    healthRunId;
     /** PM supervisor managing this app's processes (bootstrap mode) */
     supervisor = null;
     /** The raw child_process.ChildProcess (classic mode only) */
     childProcess = null;
     /** Instance count for scaling */
     instanceCount = 1;
-    /** Netron-native service router for topology */
-    serviceRouter = null;
+    /** Native Netron listener and services owned by this application launch. */
+    topology = null;
     /**
      * The app's own `logger.level`, read from its `config/default.json`.
      *
@@ -72,8 +85,6 @@ export class AppHandle {
      * have N live workers).
      */
     topologyPools = new Map();
-    /** Timer for classic-mode crash restart backoff (cleared on explicit stop) */
-    crashRestartTimer = null;
     /** Stdout/stderr log buffer (ring buffer) */
     logBuffer = [];
     maxLogLines = 1000;
@@ -89,6 +100,8 @@ export class AppHandle {
      * a successful start and the next exit. Set by `recordExit()`.
      */
     lastExit = null;
+    /** Sliding recovery budget; lifetime restarts remain a separate diagnostic. */
+    restartWindow = new RestartWindow();
     definition;
     constructor(entry, mode) {
         this.mode = mode;
@@ -102,13 +115,19 @@ export class AppHandle {
     get entry() {
         return this.definition;
     }
+    /** Redefinition revokes lifecycle work admitted against an earlier definition,
+     * even when an operator later restores the same entry object. */
+    nextDefinitionRevision = 0;
+    get definitionRevision() {
+        return this.nextDefinitionRevision;
+    }
     /**
      * Take a new definition for the next start.
      *
      * The handle captured its entry once, at the first start, and every restart
      * reused it — so a deployment that rewrote an app's environment and then
-     * restarted it restarted it on the old one. Measured on daos/test,
-     * 2026-09-23: paysys came back pointed at the chain's old address after a
+     * restarted it restarted it on the old one. Measured on sample/test,
+     * 2026-09-23: payments came back pointed at the chain's old address after a
      * deployment had written the new one to the node.
      *
      * Refused for another name: a handle is keyed by its app's name, and a
@@ -119,6 +138,7 @@ export class AppHandle {
             throw new Error(`A definition for '${entry.name}' cannot redefine '${this.definition.name}'`);
         }
         this.definition = entry;
+        this.nextDefinitionRevision++;
     }
     get name() {
         return this.entry.name;
@@ -192,7 +212,7 @@ export class AppHandle {
      * A bootstrap app used to take every child's start as its own: each
      * `child:started` called `markOnline(childPid)`, so the app was `online`
      * from its FIRST child, and its pid was that of its LAST. Measured on
-     * daos/dev/main: pid 58130, the notification-worker, while port 3001 was
+     * sample/dev/main: pid 58130, the notification-worker, while port 3001 was
      * held by the http process, 57952 — four of six apps the same way. That
      * pid is what `list` prints, what the console calls «the app's PID», what
      * `inspect` measured (181.9 MB of the app's 661.8 MB), and what the ghost
@@ -207,6 +227,13 @@ export class AppHandle {
     declaredChildren = [];
     serverChild = null;
     startedChildren = new Set();
+    startupPending = false;
+    /** Process readiness alone cannot admit an unfinished topology. */
+    deferStartup() { this.startupPending = true; }
+    finishStartup() {
+        this.startupPending = false;
+        return this.updateOnline();
+    }
     declareChildren(children, serverChild) {
         this.declaredChildren = [...children];
         this.serverChild = serverChild;
@@ -222,9 +249,16 @@ export class AppHandle {
      * still down), because a partial app is not an online one.
      */
     childStarted(child, pid) {
+        if (this.startedChildren.has(child))
+            this.invalidateRelease();
         this.startedChildren.add(child);
         if (child === this.serverChild)
             this.pid = pid;
+        return this.updateOnline();
+    }
+    updateOnline() {
+        if (this.startupPending || this.status === 'stopping' || this.status === 'stopped')
+            return false;
         if (!this.declaredChildren.every((name) => this.startedChildren.has(name)))
             return false;
         this.status = 'online';
@@ -236,6 +270,7 @@ export class AppHandle {
      * holding the dead one would let the liveness check vouch for nothing.
      */
     childGone(child) {
+        this.invalidateRelease();
         this.startedChildren.delete(child);
         if (child === this.serverChild)
             this.pid = null;
@@ -248,10 +283,6 @@ export class AppHandle {
         this.pid = null;
         this.childProcess = null;
         this.supervisor = null;
-        if (this.crashRestartTimer) {
-            clearTimeout(this.crashRestartTimer);
-            this.crashRestartTimer = null;
-        }
     }
     markErrored() {
         this.status = 'errored';

package/dist/orchestrator/app-handle.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-handle.js","sourceRoot":"","sources":["../../src/orchestrator/app-handle.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"app-handle.js","sourceRoot":"","sources":["../../src/orchestrator/app-handle.ts"],"names":[],"mappings":"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"}

package/dist/orchestrator/application-runtime-child.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=application-runtime-child.d.ts.map

package/dist/orchestrator/application-runtime-child.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-runtime-child.d.ts","sourceRoot":"","sources":["../../src/orchestrator/application-runtime-child.ts"],"names":[],"mappings":""}

package/dist/orchestrator/application-runtime-child.js

@@ -0,0 +1,15 @@
+/** Resolve an installed adapter using Node's current filesystem/module graph. */
+import { resolveApplicationBootstrapRuntime } from './application-runtime-resolution.js';
+import { initializeModuleReader, answerModuleRead } from '../shared/fresh-module-reader.js';
+initializeModuleReader();
+try {
+    const bootstrap = process.argv[2];
+    const fallback = process.argv[3];
+    if (!bootstrap || !fallback)
+        throw new Error('Application runtime entry paths were not supplied');
+    answerModuleRead({ ok: true, value: resolveApplicationBootstrapRuntime(bootstrap, fallback, process.argv[4] === '--allow-sdkless-bootstrap') });
+}
+catch (error) {
+    answerModuleRead({ ok: false, error });
+}
+//# sourceMappingURL=application-runtime-child.js.map

package/dist/orchestrator/application-runtime-child.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-runtime-child.js","sourceRoot":"","sources":["../../src/orchestrator/application-runtime-child.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,OAAO,EAAE,kCAAkC,EAAE,MAAM,qCAAqC,CAAC;AACzF,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAE5F,sBAAsB,EAAE,CAAC;AAGzB,IAAI,CAAC;IACH,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjC,IAAI,CAAC,SAAS,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IAClG,gBAAgB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,kCAAkC,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,2BAA2B,CAAC,EAAE,CAAC,CAAC;AAClJ,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,gBAAgB,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AACzC,CAAC"}

package/dist/orchestrator/application-runtime-resolution.d.ts

@@ -0,0 +1,4 @@
+/** Shared policy for fresh readers and the one-shot remote installer.
+ * Only resolves entries; never executes application code or runs in a resident owner. */
+export declare function resolveApplicationBootstrapRuntime(bootstrap: string, fallback: string, allowSdklessBootstrap?: boolean): string;
+//# sourceMappingURL=application-runtime-resolution.d.ts.map

package/dist/orchestrator/application-runtime-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-runtime-resolution.d.ts","sourceRoot":"","sources":["../../src/orchestrator/application-runtime-resolution.ts"],"names":[],"mappings":"AAIA;yFACyF;AACzF,wBAAgB,kCAAkC,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,qBAAqB,UAAQ,GAAG,MAAM,CAiD7H"}

package/dist/orchestrator/application-runtime-resolution.js

@@ -0,0 +1,62 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { createRequire } from 'node:module';
+/** Shared policy for fresh readers and the one-shot remote installer.
+ * Only resolves entries; never executes application code or runs in a resident owner. */
+export function resolveApplicationBootstrapRuntime(bootstrap, fallback, allowSdklessBootstrap = false) {
+    if (!path.isAbsolute(bootstrap) || !path.isAbsolute(fallback)) {
+        throw new Error('Application runtime resolution requires absolute entry paths');
+    }
+    const request = createRequire(bootstrap);
+    function installed(name) {
+        try {
+            return request.resolve(name);
+        }
+        catch (error) {
+            if (error.code === 'MODULE_NOT_FOUND' &&
+                !request.resolve.paths(name)?.some(directory => fs.lstatSync(path.join(directory, name), { throwIfNoEntry: false })))
+                return undefined;
+            throw new Error('The installed application package ' + name + ' cannot be resolved; repair its dependency installation', { cause: error });
+        }
+    }
+    const entry = installed('@omnitron-dev/omnitron');
+    const application = installed('@omnitron-dev/titan');
+    // A directly supervising daemon also accepts plain bootstrap files. A missing
+    // dependency declared by the application is an installation error.
+    if (!entry && !application && allowSdklessBootstrap) {
+        let directory = path.dirname(bootstrap);
+        while (true) {
+            const manifest = path.join(directory, 'package.json');
+            if (fs.existsSync(manifest)) {
+                const pkg = JSON.parse(fs.readFileSync(manifest, 'utf8'));
+                const sections = [pkg.dependencies, pkg.peerDependencies, pkg.optionalDependencies, pkg.devDependencies];
+                if (sections.some(deps => deps && (Object.hasOwn(deps, '@omnitron-dev/omnitron') || Object.hasOwn(deps, '@omnitron-dev/titan'))))
+                    throw new Error('The application declares a missing Omnitron or Titan package; install its dependencies');
+                break;
+            }
+            const parent = path.dirname(directory);
+            if (directory === parent)
+                break;
+            directory = parent;
+        }
+        return fallback;
+    }
+    if (!application)
+        throw new Error('The application Titan runtime cannot be resolved; install the application dependencies');
+    if (!entry) {
+        const owner = createRequire(fallback).resolve('@omnitron-dev/titan');
+        if (fs.realpathSync(owner) === fs.realpathSync(application))
+            return fallback;
+        throw new Error('The application uses a different Titan runtime. Install an aligned @omnitron-dev/omnitron adapter with the application before starting it.');
+    }
+    const adapter = path.join(path.dirname(entry), 'orchestrator/bootstrap-process.js');
+    if (!fs.statSync(adapter, { throwIfNoEntry: false })?.isFile()) {
+        throw new Error('The application Omnitron package has no compiled bootstrap adapter');
+    }
+    const actual = createRequire(adapter).resolve('@omnitron-dev/titan');
+    if (fs.realpathSync(application) !== fs.realpathSync(actual)) {
+        throw new Error('The application and its Omnitron adapter resolve different Titan instances; align their installed dependencies');
+    }
+    return adapter;
+}
+//# sourceMappingURL=application-runtime-resolution.js.map

package/dist/orchestrator/application-runtime-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-runtime-resolution.js","sourceRoot":"","sources":["../../src/orchestrator/application-runtime-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;yFACyF;AACzF,MAAM,UAAU,kCAAkC,CAAC,SAAiB,EAAE,QAAgB,EAAE,qBAAqB,GAAG,KAAK;IACnH,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACzC,SAAS,SAAS,CAAC,IAAY;QAC7B,IAAI,CAAC;YAAC,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;QACrC,OAAO,KAAK,EAAE,CAAC;YACb,IAAK,KAA+B,CAAC,IAAI,KAAK,kBAAkB;gBAC5D,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC;gBAAE,OAAO,SAAS,CAAC;YAC3I,MAAM,IAAI,KAAK,CAAC,oCAAoC,GAAG,IAAI,GAAG,yDAAyD,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7I,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,SAAS,CAAC,wBAAwB,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,SAAS,CAAC,qBAAqB,CAAC,CAAC;IACrD,8EAA8E;IAC9E,mEAAmE;IACnE,IAAI,CAAC,KAAK,IAAI,CAAC,WAAW,IAAI,qBAAqB,EAAE,CAAC;QACpD,IAAI,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACxC,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YACtD,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;gBAC1D,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,gBAAgB,EAAE,GAAG,CAAC,oBAAoB,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC;gBACzG,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,wBAAwB,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC;oBAC9H,MAAM,IAAI,KAAK,CAAC,wFAAwF,CAAC,CAAC;gBAC5G,MAAM;YACR,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACvC,IAAI,SAAS,KAAK,MAAM;gBAAE,MAAM;YAChC,SAAS,GAAG,MAAM,CAAC;QACrB,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,CAAC,WAAW;QAAE,MAAM,IAAI,KAAK,CAAC,wFAAwF,CAAC,CAAC;IAC5H,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;QACrE,IAAI,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,YAAY,CAAC,WAAW,CAAC;YAAE,OAAO,QAAQ,CAAC;QAC7E,MAAM,IAAI,KAAK,CAAC,4IAA4I,CAAC,CAAC;IAChK,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,mCAAmC,CAAC,CAAC;IACpF,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IACD,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACrE,IAAI,EAAE,CAAC,YAAY,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,gHAAgH,CAAC,CAAC;IACpI,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/orchestrator/application-runtime.d.ts

@@ -0,0 +1,3 @@
+/** Keep an application's Titan/DI identity independent of the controller's release. */
+export declare function applicationBootstrapRuntime(bootstrap: string, fallback: string, allowSdklessBootstrap?: boolean): Promise<string>;
+//# sourceMappingURL=application-runtime.d.ts.map

package/dist/orchestrator/application-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-runtime.d.ts","sourceRoot":"","sources":["../../src/orchestrator/application-runtime.ts"],"names":[],"mappings":"AAGA,uFAAuF;AACvF,wBAAsB,2BAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,qBAAqB,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAerI"}

package/dist/orchestrator/application-runtime.js

@@ -0,0 +1,20 @@
+import path from 'node:path';
+import { readInFreshProcess, moduleReaderEntry } from '../shared/fresh-module-reader.js';
+/** Keep an application's Titan/DI identity independent of the controller's release. */
+export async function applicationBootstrapRuntime(bootstrap, fallback, allowSdklessBootstrap = false) {
+    // createRequire() shares Node's resolution and realpath caches. Recreating
+    // the require function does not observe a replaced pnpm link or package.json
+    // in a resident owner. Use the same bounded reader as application metadata;
+    // never clear global loader internals or retain another module graph here.
+    const adapter = await readInFreshProcess({
+        entryPath: moduleReaderEntry(import.meta.url, 'application-runtime-child'),
+        args: allowSdklessBootstrap ? [bootstrap, fallback, '--allow-sdkless-bootstrap'] : [bootstrap, fallback],
+        timeoutMs: 10_000,
+        label: 'the current application runtime',
+    });
+    if (typeof adapter !== 'string' || !path.isAbsolute(adapter)) {
+        throw new Error('The application runtime reader returned an invalid adapter path');
+    }
+    return adapter;
+}
+//# sourceMappingURL=application-runtime.js.map

package/dist/orchestrator/application-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-runtime.js","sourceRoot":"","sources":["../../src/orchestrator/application-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAEzF,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,SAAiB,EAAE,QAAgB,EAAE,qBAAqB,GAAG,KAAK;IAClH,2EAA2E;IAC3E,6EAA6E;IAC7E,4EAA4E;IAC5E,2EAA2E;IAC3E,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC;QACvC,SAAS,EAAE,iBAAiB,CAAC,OAAO,IAAI,CAAC,GAAG,EAAE,2BAA2B,CAAC;QAC1E,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,2BAA2B,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC;QACxG,SAAS,EAAE,MAAM;QACjB,KAAK,EAAE,iCAAiC;KACzC,CAAC,CAAC;IACH,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/orchestrator/application-topology.d.ts

@@ -0,0 +1,20 @@
+import type { ILogger } from '@omnitron-dev/titan/module/logger';
+import { ServiceRouter } from './service-router.js';
+/** One application launch owns one native Netron service namespace and listener. */
+export declare class ApplicationTopology {
+    private readonly directory;
+    private readonly netron;
+    readonly router: ServiceRouter;
+    readonly url: string;
+    private closing;
+    private closingRequested;
+    private closed;
+    private constructor();
+    /** Allocate before starting so the application handle owns failed starts too. */
+    static allocate(parent: string, application: string, logger: ILogger): Promise<ApplicationTopology>;
+    start(): Promise<void>;
+    /** Retain ownership after a failed close; a later stop retries the same resources. */
+    close(): Promise<void>;
+    private release;
+}
+//# sourceMappingURL=application-topology.d.ts.map

package/dist/orchestrator/application-topology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-topology.d.ts","sourceRoot":"","sources":["../../src/orchestrator/application-topology.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,oFAAoF;AACpF,qBAAa,mBAAmB;IAQ5B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IARzB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO,eAON;IAED,iFAAiF;IACjF,OAAa,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA+BxG;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAG3B;IAED,sFAAsF;IACtF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAKrB;YAEa,OAAO;CAStB"}

package/dist/orchestrator/application-topology.js

@@ -0,0 +1,90 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { Netron } from '@omnitron-dev/titan/netron';
+import { UnixSocketTransport } from '@omnitron-dev/titan/netron/transport/unix';
+import { AuthenticationManager, AuthorizationManager } from '@omnitron-dev/titan/netron/auth';
+import { ServiceRouter } from './service-router.js';
+/** One application launch owns one native Netron service namespace and listener. */
+export class ApplicationTopology {
+    directory;
+    netron;
+    router;
+    url;
+    closing = null;
+    closingRequested = false;
+    closed = false;
+    constructor(directory, netron, logger) {
+        this.directory = directory;
+        this.netron = netron;
+        this.router = new ServiceRouter(netron, logger);
+        this.url = `unix://${path.join(directory, 'rpc.sock')}`;
+    }
+    /** Allocate before starting so the application handle owns failed starts too. */
+    static async allocate(parent, application, logger) {
+        await fs.mkdir(parent, { recursive: true, mode: 0o700 });
+        const stat = await fs.lstat(parent);
+        if (!stat.isDirectory() || stat.isSymbolicLink() || (stat.mode & 0o077) !== 0 ||
+            (process.getuid && stat.uid !== process.getuid())) {
+            throw new Error('Application topology directory must be private and owned by this user');
+        }
+        const root = await fs.realpath(parent);
+        if (root.includes('?') || Buffer.byteLength(path.join(root, 't-XXXXXX', 'rpc.sock')) > 100) {
+            throw new Error('Application topology directory cannot contain ? and must fit a 100-byte Unix socket path');
+        }
+        const directory = await fs.mkdtemp(path.join(root, 't-'));
+        try {
+            const netron = new Netron(logger, { id: `topology-${path.basename(directory)}` });
+            netron.registerTransport('unix', () => new UnixSocketTransport());
+            netron.registerTransportServer('unix', { name: 'application-topology', options: {
+                    path: path.join(directory, 'rpc.sock'), force: false, mode: 0o600,
+                } });
+            netron.configureAuth(new AuthenticationManager(logger, {
+                authenticate: async () => { throw new Error('Application topology requires its private Unix socket'); },
+                validateToken: async () => { throw new Error('Application topology does not accept bearer tokens'); },
+                tokenCache: { enabled: false },
+            }), new AuthorizationManager(logger));
+            netron.setTransportAuthContext('unix', {
+                userId: application, roles: ['application-topology'], permissions: [],
+            });
+            return new ApplicationTopology(directory, netron, logger);
+        }
+        catch (error) {
+            await fs.rmdir(directory);
+            throw error;
+        }
+    }
+    async start() {
+        if (this.closingRequested)
+            throw new Error('Application topology is closing or closed');
+        await this.netron.start();
+    }
+    /** Retain ownership after a failed close; a later stop retries the same resources. */
+    close() {
+        this.closingRequested = true;
+        if (this.closed)
+            return Promise.resolve();
+        this.closing ??= this.release().finally(() => { this.closing = null; });
+        return this.closing;
+    }
+    async release() {
+        const failures = [];
+        try {
+            await this.router.releaseAll();
+        }
+        catch (error) {
+            failures.push(error);
+        }
+        try {
+            await this.netron.stop();
+        }
+        catch (error) {
+            failures.push(error);
+        }
+        if (failures.length)
+            throw new AggregateError(failures, 'Application topology shutdown incomplete');
+        // No recursive removal: an unexpected file is evidence, not disposable state.
+        await fs.rmdir(this.directory);
+        this.closed = true;
+    }
+}
+//# sourceMappingURL=application-topology.js.map

package/dist/orchestrator/application-topology.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-topology.js","sourceRoot":"","sources":["../../src/orchestrator/application-topology.ts"],"names":[],"mappings":"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"}

package/dist/orchestrator/bootstrap-loader-child.d.ts

@@ -10,7 +10,7 @@
  * now.
  *
  * It reads the definition as the daemon would have in its own process: the
- * same loader code (`loadBootstrapConfig`, dev mode, in-process), the same Node
+ * same loader code (`loadBootstrapConfig`, selected mode, in-process), the same Node
  * flags (`--import tsx/esm` among them), working directory and environment.
  * Then it answers once over IPC and exits, whatever the definition left open —
  * a client, a timer — since nothing here will ever use it.

package/dist/orchestrator/bootstrap-loader-child.js

@@ -10,34 +10,25 @@
  * now.
  *
  * It reads the definition as the daemon would have in its own process: the
- * same loader code (`loadBootstrapConfig`, dev mode, in-process), the same Node
+ * same loader code (`loadBootstrapConfig`, selected mode, in-process), the same Node
  * flags (`--import tsx/esm` among them), working directory and environment.
  * Then it answers once over IPC and exits, whatever the definition left open —
  * a client, a timer — since nothing here will ever use it.
  */
-import { FRESH_GRAPH_ANSWER, definitionAsData, loadBootstrapConfig, } from './bootstrap-loader.js';
-// The parent is the only one this answer is for. Gone, it leaves nothing to do.
-process.once('disconnect', () => process.exit(3));
-function answer(message) {
-    const code = message.ok ? 0 : 1;
-    if (!process.send) {
-        process.stderr.write('bootstrap-loader-child: started without an IPC channel, so there is no one to answer\n');
-        process.exit(2);
-    }
-    process.send(message, undefined, {}, () => process.exit(code));
-}
+import { definitionAsData, loadBootstrapConfig } from './bootstrap-loader.js';
+import { initializeModuleReader, answerModuleRead } from '../shared/fresh-module-reader.js';
+initializeModuleReader();
 const bootstrapPath = process.argv[2];
 try {
     if (!bootstrapPath)
         throw new Error('no definition path was given');
-    const definition = await loadBootstrapConfig(bootstrapPath, { devMode: true });
+    const definition = await loadBootstrapConfig(bootstrapPath, { devMode: process.argv[3] !== 'production' });
     const data = definitionAsData(definition);
     if (data === undefined)
         throw new Error('the definition loaded, but could not be read as data');
-    answer({ type: FRESH_GRAPH_ANSWER, ok: true, definition: data });
+    answerModuleRead({ ok: true, value: data });
 }
 catch (err) {
-    const error = err instanceof Error ? err : new Error(String(err));
-    answer({ type: FRESH_GRAPH_ANSWER, ok: false, message: error.message, name: error.name, stack: error.stack });
+    answerModuleRead({ ok: false, error: err });
 }
 //# sourceMappingURL=bootstrap-loader-child.js.map

package/dist/orchestrator/bootstrap-loader-child.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap-loader-child.js","sourceRoot":"","sources":["../../src/orchestrator/bootstrap-loader-child.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,GAEpB,MAAM,uBAAuB,CAAC;AAE/B,gFAAgF;AAChF,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAElD,SAAS,MAAM,CAAC,OAAyB;IACvC,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wFAAwF,CAAC,CAAC;QAC/G,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACtC,IAAI,CAAC;IACH,IAAI,CAAC,aAAa;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACpE,MAAM,UAAU,GAAG,MAAM,mBAAmB,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/E,MAAM,IAAI,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAChG,MAAM,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;AACnE,CAAC;AAAC,OAAO,GAAG,EAAE,CAAC;IACb,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAClE,MAAM,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;AAChH,CAAC"}
+{"version":3,"file":"bootstrap-loader-child.js","sourceRoot":"","sources":["../../src/orchestrator/bootstrap-loader-child.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAE5F,sBAAsB,EAAE,CAAC;AAEzB,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACtC,IAAI,CAAC;IACH,IAAI,CAAC,aAAa;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACpE,MAAM,UAAU,GAAG,MAAM,mBAAmB,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,YAAY,EAAE,CAAC,CAAC;IAC3G,MAAM,IAAI,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAChG,gBAAgB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9C,CAAC;AAAC,OAAO,GAAG,EAAE,CAAC;IACb,gBAAgB,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;AAC9C,CAAC"}