@omnitron-dev/omnitron 0.1.3 → 0.3.0

package/dist/orchestrator/call-exposed-service.js

@@ -0,0 +1,50 @@
+/**
+ * Call a service method on whichever of a bootstrap app's processes exposes it.
+ *
+ * `omnitron exec` asked the FIRST child's process proxy for
+ * `proxy[service][method]`. The proxy answers a remote-call function for ANY
+ * property name, so `proxy[service]` was a function and `[method]` on it
+ * undefined: `omnitron exec main NotificationWorker getStatus` answered
+ * «Method with id NotificationWorker.getStatus not found» for a method that
+ * exists — in the notification-worker process, which the first child is not.
+ * The working path is the one `ServiceRouter` uses: each process lists the
+ * services it exposes (`getExposedServices`) and runs a call on one of them
+ * (`callExposedService`).
+ *
+ * Shared by `exec` and by the alert sink's delivery (services/alert.service.ts),
+ * so the operator's command and the daemon's own calls take one road — over the
+ * supervisor's socket into the process, never over the app's HTTP transport.
+ * Only a method a process lists — one Titan enumerates, `@Public` — is callable.
+ *
+ * And only in a CHILD: a pool worker (`(worker) ×N` in `omnitron list`) is not
+ * among the processes this walks — it is reached through its topology proxy
+ * instead. `omnitron exec storage TransformWorker ping` answers «not found»
+ * (measured 2026-09-29) while `omnitron exec priceverse CollectorWorker
+ * getAllStats`, a `(custom)` child, answers. An alert sink, or anything else
+ * called this way, has to live in a `(custom)` child.
+ */
+import { Errors } from '@omnitron-dev/titan/errors';
+export async function callExposedService(supervisor, appName, service, method, args) {
+    const childNames = supervisor.getChildNames();
+    if (childNames.length === 0)
+        throw Errors.conflict(`No running children for app '${appName}'`);
+    const wanted = service.split('@')[0];
+    const offered = [];
+    for (const child of childNames) {
+        const proxy = (await supervisor.getChildProxy(child));
+        if (!proxy?.getExposedServices || !proxy.callExposedService)
+            continue;
+        const services = await proxy.getExposedServices();
+        const match = services.find((svc) => svc.name === wanted || svc.name.split('@')[0] === wanted);
+        if (!match) {
+            offered.push(...services.map((svc) => `${svc.name} (${child})`));
+            continue;
+        }
+        if (!match.methods.includes(method)) {
+            throw Errors.notFound('Method', `${service}.${method} — ${match.name} in ${child} offers: ${match.methods.join(', ') || 'no public methods'}`);
+        }
+        return proxy.callExposedService(service, method, args);
+    }
+    throw Errors.notFound('Service', `${service} in ${appName} — its processes expose: ${offered.join(', ') || 'no services'}`);
+}
+//# sourceMappingURL=call-exposed-service.js.map

package/dist/orchestrator/call-exposed-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-exposed-service.js","sourceRoot":"","sources":["../../src/orchestrator/call-exposed-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAapD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAA8B,EAC9B,OAAe,EACf,OAAe,EACf,MAAc,EACd,IAAe;IAEf,MAAM,UAAU,GAAG,UAAU,CAAC,aAAa,EAAE,CAAC;IAC9C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,MAAM,CAAC,QAAQ,CAAC,gCAAgC,OAAO,GAAG,CAAC,CAAC;IAE/F,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,CAAC,MAAM,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,CAA2B,CAAC;QAChF,IAAI,CAAC,KAAK,EAAE,kBAAkB,IAAI,CAAC,KAAK,CAAC,kBAAkB;YAAE,SAAS;QACtE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,kBAAkB,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC;QAC/F,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC;YACjE,SAAS;QACX,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACpC,MAAM,MAAM,CAAC,QAAQ,CACnB,QAAQ,EACR,GAAG,OAAO,IAAI,MAAM,MAAM,KAAK,CAAC,IAAI,OAAO,KAAK,YAAY,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,mBAAmB,EAAE,CAC9G,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,MAAM,CAAC,QAAQ,CACnB,SAAS,EACT,GAAG,OAAO,OAAO,OAAO,4BAA4B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,aAAa,EAAE,CAC1F,CAAC;AACJ,CAAC"}

package/dist/orchestrator/classic-launcher.d.ts

@@ -14,4 +14,5 @@ import type { IEcosystemAppEntry } from '../config/types.js';
 import type { AppHandle } from './app-handle.js';
 import type { ILogger } from '@omnitron-dev/titan/module/logger';
 export declare function launchClassic(entry: IEcosystemAppEntry, handle: AppHandle, cwd: string, logger: ILogger, logHandlers?: Array<(appName: string, line: string) => void>): Promise<ChildProcess>;
+export declare function waitForReady(child: ChildProcess, handle: AppHandle, logger: ILogger): Promise<void>;
 //# sourceMappingURL=classic-launcher.d.ts.map

package/dist/orchestrator/classic-launcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"classic-launcher.d.ts","sourceRoot":"","sources":["../../src/orchestrator/classic-launcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAQ,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AAGjE,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,OAAO,EACf,WAAW,GAAE,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAM,GAC/D,OAAO,CAAC,YAAY,CAAC,CA0DvB"}
+{"version":3,"file":"classic-launcher.d.ts","sourceRoot":"","sources":["../../src/orchestrator/classic-launcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAQ,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AAGjE,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,OAAO,EACf,WAAW,GAAE,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAM,GAC/D,OAAO,CAAC,YAAY,CAAC,CAsEvB;AAsBD,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA4CnG"}

package/dist/orchestrator/classic-launcher.js

@@ -33,10 +33,22 @@ export async function launchClassic(entry, handle, cwd, logger, logHandlers = []
         OMNITRON_APP_NAME: entry.name,
     };
     handle.markStarting();
+    // `detached: true` puts the child in its own process group with
+    // pgid === pid. On stop we send the signal to `-pid` so the entire
+    // group (the child plus any grandchildren it forks: ffmpeg, docker,
+    // worker pools, etc.) is reaped together. Without this, a classic-
+    // mode app that itself spawns long-lived helpers leaves orphans
+    // holding ports after `omnitron stop`. The janitor only sweeps
+    // `fork-worker.js`, so classic-mode grandchildren survive forever.
+    //
+    // We do NOT call `child.unref()` — the daemon must remain
+    // responsible for the child's lifecycle, so it should keep
+    // appearing in `daemon.pid` accounting.
     const child = fork(scriptPath, [], {
         cwd,
         env,
         stdio: ['pipe', 'pipe', 'pipe', 'ipc'],
+        detached: true,
         // No tsx execArgv — script is either pre-compiled .js or bundled via esbuild
         ...(scriptPath.endsWith('.ts') ? { execArgv: ['--import', 'tsx/esm'] } : {}),
     });
@@ -64,7 +76,26 @@ export async function launchClassic(entry, handle, cwd, logger, logHandlers = []
     await waitForReady(child, handle, logger);
     return child;
 }
-function waitForReady(child, handle, logger) {
+/**
+ * Say WHY a starting child is gone.
+ *
+ * Node's `'exit'` carries `(code, signal)` and exactly one of them is set. A
+ * signalled exit reports `code === null`, so a handler that reads only `code`
+ * turns every kill into "code null" — which reads as though the process chose
+ * to exit and returned nothing, and sends the reader to the app's startup path
+ * instead of to the machine.
+ *
+ * The signal is the diagnosis. SIGKILL is the OOM killer, a jetsam eviction
+ * under memory pressure, or someone's `kill -9` — nothing in the process chose
+ * it and no amount of reading the app will explain it. SIGTERM is a deliberate
+ * stop. SIGSEGV is a crash in native code. `doctor` already tells an operator
+ * that "SIGKILL usually means the OOM killer or a hard timeout"; it could not
+ * say so from this message, because this message did not carry it.
+ */
+function describeExit(code, signal) {
+    return signal ? `: killed by ${signal}` : `with code ${code}`;
+}
+export function waitForReady(child, handle, logger) {
     return new Promise((resolve, reject) => {
         let settled = false;
         const timeout = setTimeout(() => {
@@ -87,13 +118,13 @@ function waitForReady(child, handle, logger) {
                 resolve();
             }
         };
-        const onExit = (code) => {
+        const onExit = (code, signal) => {
             if (settled)
                 return;
             settled = true;
             clearTimeout(timeout);
             handle.markErrored();
-            reject(new Error(`App '${handle.name}' exited during startup with code ${code}`));
+            reject(new Error(`App '${handle.name}' exited during startup ${describeExit(code, signal)}`));
         };
         const onError = (err) => {
             if (settled)

package/dist/orchestrator/classic-launcher.js.map

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

package/dist/orchestrator/file-watcher.d.ts

@@ -5,6 +5,17 @@
  * On file change → debounce → orchestrator.restartApp() which handles
  * any topology: single-process, multi-process (server + worker pools), classic fork.
  *
+ * Platform note (macOS): `{ recursive: true }` is backed by FSEvents, which
+ * behaves materially differently from inotify. The stream takes a few hundred
+ * milliseconds to arm after `fs.watch()` returns, and writes in that window
+ * are dropped outright — not delivered late. Steady-state delivery then lags
+ * by roughly a second. In practice this means an edit made in the first
+ * moments after the daemon starts watching may not trigger a restart, and
+ * every restart is ~1s behind the save. Node exposes no readiness signal for
+ * `fs.watch`, so this is a property of the platform rather than something the
+ * watcher can correct; `test/unit/file-watcher.test.ts` documents the
+ * measurements and works around it by waiting for observed delivery.
+ *
  * Design:
  *   - One recursive watcher per app directory
  *   - Debounce: 300ms per app (accumulates changes, then triggers single restart)
@@ -12,13 +23,14 @@
  *   - Restart-aware: won't trigger new restart while one is in progress
  *   - Topology-transparent: orchestrator.restartApp() handles full topology teardown/startup
  */
+import fs from 'node:fs';
 import type { ILogger } from '@omnitron-dev/titan/module/logger';
 import type { IEcosystemConfig, IEcosystemAppEntry } from '../config/types.js';
 import type { OrchestratorService } from './orchestrator.service.js';
 export declare class FileWatcher {
     private readonly logger;
     private readonly orchestrator;
-    private readonly config;
+    private config;
     private readonly cwd;
     private readonly debounceMs;
     private readonly apps;
@@ -34,20 +46,85 @@ export declare class FileWatcher {
     addApp(entry: IEcosystemAppEntry): void;
     /** Dynamically remove watch for an app */
     removeApp(name: string): void;
+    /**
+     * Bring the watch set in line with a reloaded config.
+     *
+     * `addApp` and `removeApp` existed for exactly this and had no caller
+     * outside their test, so a config reload — `omnitron reload`, or SIGHUP —
+     * updated the orchestrator and the daemon's RPC snapshot and left the
+     * watcher on the old set. An app added to the config was never watched
+     * until the next daemon restart, and an app removed from it kept its
+     * watchers: edits to a file under a deleted app went on restarting
+     * something the config no longer describes.
+     *
+     * Renaming counts as both, which is the case that makes doing this by hand
+     * at the call site error-prone.
+     */
+    applyConfig(config: IEcosystemConfig): void;
     /** Get list of watched apps and their directories */
     getWatchedApps(): Array<{
         name: string;
         directory: string;
     }>;
+    /**
+     * The single call into the platform watcher.
+     *
+     * Exists as an overridable seam because the behaviour worth testing here —
+     * ignore rules, debouncing, the restart queue — is this class's, while
+     * `fs.watch` on macOS is FSEvents: it drops writes issued before the stream
+     * arms and then delivers with a delay measured in seconds (3.6s under load
+     * in one measured run). Driving the tests through real file writes made
+     * them slow, flaky, and — before they were rewritten — silently vacuous.
+     * Tests substitute a deterministic emitter through this method; one
+     * end-to-end case still exercises the real thing.
+     *
+     * Production callers must not override it.
+     */
+    protected watchDirectory(dir: string, onEvent: (eventType: string, filename: string | null) => void): fs.FSWatcher;
     private watchApp;
     private resolveWatchConfig;
     private onFileChange;
     private triggerRestart;
+    /**
+     * Whether a changed path is one a restart cannot be a response to.
+     *
+     * `extraIgnore` — the per-app `ignore` option — is compared as a whole path
+     * SEGMENT, which is what it has always done. Its docblock in
+     * `config/types.ts` used to call the values "glob patterns", so
+     * `ignore: ['test/**']` read as configured and matched nothing: an operator
+     * would write the glob, see it in the config, and believe the directory was
+     * covered. The documentation now says what this does. Real globs would be a
+     * dependency and a deliberate feature, not an accident of wording.
+     */
     private shouldIgnore;
     /**
      * Resolve the app's root directory from its bootstrap/script entry path.
      * Walks up from the entry file until a package.json is found.
      */
+    /**
+     * The directory to watch for an app, from its entry file.
+     *
+     * Returns null when the entry file is not where the base says it is,
+     * rather than walking up from a path that does not exist.
+     *
+     * That walk was the defect. `watch: { directory: './apps/storage' }` and
+     * `bootstrap: './apps/storage/src/bootstrap.ts'` are relative to the
+     * PROJECT root; when `entry.cwd` is unset the base falls back to the
+     * daemon's cwd, which here is `apps/omnitron`. Resolving gives
+     * `apps/omnitron/apps/storage/src/bootstrap.ts` — nothing — and the walk
+     * up from it finds the first `package.json` on the way to the filesystem
+     * root, which is `apps/omnitron` itself.
+     *
+     * So every downstream app was watching the daemon's own source tree. Editing one
+     * file in `src/commands/` restarted all six of them, and editing their own
+     * sources restarted nothing: hot reload was broken in both directions and
+     * looked like it worked, because restarts kept happening.
+     *
+     * Measured on this host: `Watching for changes` named
+     * `/…/apps/omnitron` for payments, messaging, storage and pricing, and
+     * one edit to `src/commands/doctor.ts` produced four restarts in the same
+     * millisecond.
+     */
     private resolveAppRoot;
 }
 //# sourceMappingURL=file-watcher.d.ts.map

package/dist/orchestrator/file-watcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../src/orchestrator/file-watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAgB,MAAM,oBAAoB,CAAC;AAC7F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AA0CrE,qBAAa,WAAW;IAKpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAR7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiC;IACtD,OAAO,CAAC,OAAO,CAAS;gBAGL,MAAM,EAAE,OAAO,EACf,YAAY,EAAE,mBAAmB,EACjC,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,MAAM,EACX,UAAU,GAAE,MAAY;IAG3C;;;OAGG;IACH,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IAahC,IAAI,IAAI,IAAI;IAgBZ,0CAA0C;IAC1C,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAMvC,0CAA0C;IAC1C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAU7B,qDAAqD;IACrD,cAAc,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAO5D,OAAO,CAAC,QAAQ;IA+DhB,OAAO,CAAC,kBAAkB;IA8C1B,OAAO,CAAC,YAAY;YAiBN,cAAc;IA2D5B,OAAO,CAAC,YAAY;IAgBpB;;;OAGG;IACH,OAAO,CAAC,cAAc;CAiBvB"}
+{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../src/orchestrator/file-watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAgB,MAAM,oBAAoB,CAAC;AAC7F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAmErE,qBAAa,WAAW;IAKpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAR7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiC;IACtD,OAAO,CAAC,OAAO,CAAS;IAExB,YACmB,MAAM,EAAE,OAAO,EACf,YAAY,EAAE,mBAAmB,EAC1C,MAAM,EAAE,gBAAgB,EACf,GAAG,EAAE,MAAM,EACX,UAAU,GAAE,MAAY,EACvC;IAEJ;;;OAGG;IACH,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAW/B;IAED,IAAI,IAAI,IAAI,CAcX;IAED,0CAA0C;IAC1C,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAItC;IAED,0CAA0C;IAC1C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAQ5B;IAED;;;;;;;;;;;;;OAaG;IACH,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAc1C;IAED,qDAAqD;IACrD,cAAc,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAK3D;IAED;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC,SAAS,CAEjH;IAED,OAAO,CAAC,QAAQ;IAyFhB,OAAO,CAAC,kBAAkB;IAqD1B,OAAO,CAAC,YAAY;YAiBN,cAAc;IA6G5B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,YAAY;IAoBpB;;;OAGG;IACH;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,OAAO,CAAC,cAAc;CA6BvB"}