@mono-agent/agent-app 0.11.3 → 0.11.4

package/dist/app-controller.js

@@ -0,0 +1,336 @@
+// Internal host implementation; `app.ts` remains the stable public facade.
+import { resolve } from "node:path";
+import { createLiveEventBus } from "@mono-agent/agent-contracts";
+import { resolveChannelDrivers } from "./channels.js";
+import { createSeenNotifyDestinationCache } from "./seen-conversations.js";
+import { sandboxStatusFromState } from "./app-controller-utils.js";
+import * as lifecycleOperations from "./app-controller-lifecycle.js";
+import * as traceabilityOperations from "./app-controller-traceability.js";
+import * as memory_healthOperations from "./app-controller-memory-health.js";
+import * as continuationOperations from "./app-controller-continuation.js";
+import * as maintenanceOperations from "./app-controller-maintenance.js";
+import * as channelsOperations from "./app-controller-channels.js";
+import * as responderOperations from "./app-controller-responder.js";
+import * as memoryOperations from "./app-controller-memory.js";
+/**
+ * Starts a config-first mono-agent host in `cwd`: traceability first, then every
+ * configured channel in parallel. Channels with incomplete config report
+ * `waiting_for_config` instead of blocking the rest. The host runs headless;
+ * config changes take effect on the next restart.
+ */
+export async function startMonoAgentApp(options = {}) {
+    const cwd = resolve(options.cwd ?? process.cwd());
+    const configPath = resolve(cwd, options.configPath ?? "mono-agent.config.json");
+    const configReadPath = resolve(cwd, options.configReadPath ?? configPath);
+    const env = options.env ?? process.env;
+    const drivers = options.drivers ?? await resolveChannelDrivers({ env, cwd, configPath: configReadPath });
+    const controller = new MonoAgentAppController({
+        cwd,
+        configPath,
+        configReadPath,
+        env,
+        drivers,
+        ...(options.logger === undefined ? {} : { logger: options.logger }),
+        ...(options.runtime === undefined ? {} : { runtime: options.runtime }),
+        ...(options.sandboxEngine === undefined ? {} : { sandboxEngine: options.sandboxEngine }),
+        ...(options.traceDefaults === undefined ? {} : { traceDefaults: options.traceDefaults }),
+        ...(options.backgroundSnapshot === undefined ? {} : { backgroundSnapshot: options.backgroundSnapshot }),
+    });
+    await controller.refreshSandboxStatus("startup");
+    await controller.startTraceability("startup");
+    await controller.startExporters("startup");
+    await controller.startContinuationServiceIfConfigured("startup");
+    await Promise.all(drivers.map((driver) => controller?.startChannelIfConfigured(driver.id, "startup")));
+    await controller.startMemoryRitualsIfConfigured("startup");
+    await controller.refreshMemoryHealthAfterLifecycle("startup-complete");
+    return controller;
+}
+const DEFAULT_SANDBOX_STATUS = sandboxStatusFromState({
+    configured: false,
+    configuredMode: undefined,
+    effective: "off",
+    engine: undefined,
+    engineAvailable: undefined,
+    fallback: undefined,
+    fallbackActive: false,
+    unsafeAllowHostProcess: false,
+});
+/** Strict memory audits scan durable state; never run them at sub-second trace-heartbeat cadence. */
+const MIN_MEMORY_HEALTH_REFRESH_INTERVAL_MS = 30_000;
+export class MonoAgentAppController {
+    configPath;
+    cwd;
+    configReadPath;
+    env;
+    drivers;
+    driversById;
+    logger;
+    runtime;
+    sandboxEngine;
+    traceDefaults;
+    backgroundSnapshot;
+    activeRuntimes = [];
+    statuses = new Map();
+    running = new Map();
+    startsInFlight = new Map();
+    /** Captured at construction (~process start): the cutoff for reclaiming orphaned "running" runs. */
+    processStartMs = Date.now();
+    staleRunsReconciled = false;
+    traceabilityStatusValue = {
+        kind: "disabled",
+        reason: "Traceability has not started yet.",
+    };
+    exporterStatusValue = {
+        kind: "disabled",
+        reason: "No observability exporter configured.",
+    };
+    sandboxStatusValue = DEFAULT_SANDBOX_STATUS;
+    memoryHealthValue = {
+        backend: "none",
+        status: "unknown",
+        checkedAt: new Date().toISOString(),
+    };
+    memoryHealthRefreshInFlight;
+    memoryHealthRefreshTimer;
+    memoryHealthRefreshLoopActive = false;
+    memoryHealthRefreshIntervalMs = MIN_MEMORY_HEALTH_REFRESH_INTERVAL_MS;
+    /** Monotonic completion time for the current generation's cached full audit. */
+    memoryHealthLastCompletedAtMs;
+    /** One bounded forced refresh reserved by a due timer tick. */
+    memoryHealthRefreshDue = false;
+    memoryHealthGeneration = 0;
+    selectedSkillsValue;
+    sessionMetadataValue;
+    /** The exporter the responder threads into agent-host (first configured exporter). */
+    resolvedExporter;
+    traceSource;
+    /**
+     * Whole-publication single flight. A slow health probe must not let periodic
+     * heartbeat ticks build an unbounded promise tail behind it.
+     */
+    traceRefreshInFlight;
+    traceRefreshDirty = false;
+    traceRefreshLatestReason;
+    // Best-effort mirror of `traceSource` into the machine-wide global registry,
+    // present only when `shouldMirrorTraceSourceGlobally` gates it on (see
+    // `startTraceability`). Kept in lockstep with `traceSource` on every
+    // refresh/stop so both manifests describe the same instance identically.
+    globalTraceSource;
+    artifactRetentionScheduler;
+    artifactRetentionGeneration = 0;
+    memoryRituals;
+    // One shared memory store across all channel responders + the ritual scheduler, so there is a single
+    // memory.db handle (not one per channel plus one for rituals). Rebuilt on config reload, closed on stop.
+    sharedMemory = undefined;
+    sharedMemoryRetrieval;
+    sharedMemoryBuilt = false;
+    sharedMemoryBuild;
+    configApplyTail = Promise.resolve();
+    stopped = false;
+    // Interaction bridge (AskUser + tool progress): lazily started once and shared
+    // by every channel. Its master bearer stays app-owned and is never exported
+    // through the generic host/process environment.
+    interactionBridge;
+    interactionBridgeStart;
+    continuationService;
+    continuationServiceStart;
+    // Shared in-process run-event bus: every run's recorder publishes to it (via the
+    // broadcast recorder threaded as `runEventSink`), and the `live` channel relays
+    // it over SSE. One instance for the app's lifetime — cheap, bounded ring buffer,
+    // and it must exist before any responder is built (like the interaction bridge).
+    liveEventBus = createLiveEventBus();
+    /** One bounded scan cache for artifact-derived native-notify destinations. */
+    seenNotifyDestinations = createSeenNotifyDestinationCache();
+    constructor(input) {
+        this.cwd = input.cwd;
+        this.configPath = input.configPath;
+        this.configReadPath = input.configReadPath;
+        this.env = input.env;
+        this.drivers = input.drivers;
+        this.driversById = new Map(input.drivers.map((driver) => [driver.id, driver]));
+        this.logger = input.logger;
+        this.runtime = input.runtime;
+        this.sandboxEngine = input.sandboxEngine;
+        this.traceDefaults = input.traceDefaults;
+        this.backgroundSnapshot = input.backgroundSnapshot;
+        for (const driver of input.drivers) {
+            this.statuses.set(driver.id, {
+                kind: "waiting_for_config",
+                reason: `${driver.label} has not been configured yet.`,
+            });
+        }
+    }
+    get traceabilityStatus() {
+        return this.traceabilityStatusValue;
+    }
+    get exporterStatus() {
+        return this.exporterStatusValue;
+    }
+    get sandboxStatus() {
+        return this.sandboxStatusValue;
+    }
+    get memoryHealth() {
+        return this.memoryHealthValue;
+    }
+    get selectedSkills() {
+        return this.selectedSkillsValue;
+    }
+    channelStatus(id) {
+        const status = this.statuses.get(id);
+        if (status === undefined) {
+            return { kind: "disabled", reason: `Channel ${id} is not registered with this app.` };
+        }
+        return status;
+    }
+    channelStatuses() {
+        return new Map(this.statuses);
+    }
+    async continuationHealth() {
+        return await this.continuationService?.health();
+    }
+    async listContinuations() {
+        return await this.continuationService?.list() ?? [];
+    }
+    async capturedContinuationText(id) {
+        return await this.requireContinuationService().capturedText(id);
+    }
+    async retryContinuation(id, options) {
+        return await this.requireContinuationService().retry(id, options);
+    }
+    async cancelContinuation(id) {
+        return await this.requireContinuationService().cancel(id);
+    }
+    async resolveContinuationDelivery(id, outcome) {
+        return await this.requireContinuationService().resolveUnknown(id, outcome);
+    }
+    async applyConfigChange(reason) { return lifecycleOperations.applyConfigChange(this, reason); }
+    async startChannelIfConfigured(id, reason) { return lifecycleOperations.startChannelIfConfigured(this, id, reason); }
+    async startTraceability(reason) { return traceabilityOperations.startTraceability(this, reason); }
+    async refreshSandboxStatus(reason) { return traceabilityOperations.refreshSandboxStatus(this, reason); }
+    /**
+     * One-shot at startup: a process that crashed mid-run leaves its summary stuck at "running"
+     * forever (a ghost run in `status`/observability). Reclaim those — any "running" summary that
+     * began before THIS process started — by rewriting them to "interrupted". Gated so a config
+     * reload (which re-runs startTraceability) does not repeat the scan. Best-effort: never fatal.
+     */
+    async reconcileStaleRunsOnce(artifactDir) { return traceabilityOperations.reconcileStaleRunsOnce(this, artifactDir); }
+    /**
+     * Resolve the configured observability exporter(s) and publish the export
+     * status. No reachability probe runs here — Phoenix may start after the agent,
+     * so an unreachable endpoint must not block startup (that probe runs in
+     * `validate`). A present-but-invalid exporter config surfaces as `failed`.
+     */
+    async startExporters(reason) { return traceabilityOperations.startExporters(this, reason); }
+    /** Record a best-effort export warning so `status` can surface it without failing the run. */
+    recordExporterWarning(warning) { return traceabilityOperations.recordExporterWarning(this, warning); }
+    refreshTraceSource(reason) { return traceabilityOperations.refreshTraceSource(this, reason); }
+    /**
+     * Refresh the content-free memory snapshot once for all concurrent trace
+     * publishers. The cached value is the only memory state read by synchronous
+     * manifest composition; provider/native errors collapse to a closed unknown
+     * shape and never escape into registry metadata.
+     */
+    refreshMemoryHealthSnapshot(reason, lifecycleForce = false) { return memory_healthOperations.refreshMemoryHealthSnapshot(this, reason, lifecycleForce); }
+    async computeMemoryHealth() { return memory_healthOperations.computeMemoryHealth(this); }
+    startMemoryHealthRefreshLoop(intervalMs) { return memory_healthOperations.startMemoryHealthRefreshLoop(this, intervalMs); }
+    scheduleMemoryHealthRefresh(delayOverrideMs) { return memory_healthOperations.scheduleMemoryHealthRefresh(this, delayOverrideMs); }
+    recordMemoryHealthCompletion(generation) { return memory_healthOperations.recordMemoryHealthCompletion(this, generation); }
+    refreshMemoryHealthOnTimer() { return memory_healthOperations.refreshMemoryHealthOnTimer(this); }
+    /**
+     * Re-audit after channel responders and the shared memory store have started.
+     * The trace source is registered first, so its registration audit can only
+     * observe the previous/stopped runtime snapshot. This one lifecycle force is
+     * generation-fenced and uses the same health/trace single-flights as timer
+     * work; ordinary session and trace events continue to reuse the 30s cache.
+     */
+    async refreshMemoryHealthAfterLifecycle(reason) { return memory_healthOperations.refreshMemoryHealthAfterLifecycle(this, reason); }
+    clearMemoryHealthRefreshTimer() { return memory_healthOperations.clearMemoryHealthRefreshTimer(this); }
+    invalidateMemoryHealthRefresh() { return memory_healthOperations.invalidateMemoryHealthRefresh(this); }
+    /**
+     * Start the interaction bridge once, when a blocking ask tool is allowed by
+     * the tool policy, a request-context MCP needs scoped progress, or the operator
+     * configured the `interaction` block. The master bearer remains app-owned.
+     */
+    ensureInteractionBridge(coreConfig) { return continuationOperations.ensureInteractionBridge(this, coreConfig); }
+    async stopInteractionBridge() { return continuationOperations.stopInteractionBridge(this); }
+    /** Start one durable continuation service shared by all channel responders. */
+    ensureContinuationService(coreConfig) { return continuationOperations.ensureContinuationService(this, coreConfig); }
+    async startContinuationServiceIfConfigured(reason) { return continuationOperations.startContinuationServiceIfConfigured(this, reason); }
+    async stopContinuationService() { return continuationOperations.stopContinuationService(this); }
+    requireContinuationService() { return continuationOperations.requireContinuationService(this); }
+    async synthesizeContinuation(input) { return continuationOperations.synthesizeContinuation(this, input); }
+    continuationSynthesisAvailability(input) { return continuationOperations.continuationSynthesisAvailability(this, input); }
+    async deliverContinuation(conversationId, text, deliveryKey) { return continuationOperations.deliverContinuation(this, conversationId, text, deliveryKey); }
+    async recordContinuationHistory(conversationId, text, deliveryKey) { return continuationOperations.recordContinuationHistory(this, conversationId, text, deliveryKey); }
+    async stop() { return lifecycleOperations.stop(this); }
+    async startMemoryRitualsIfConfigured(reason) { return maintenanceOperations.startMemoryRitualsIfConfigured(this, reason); }
+    stopMemoryRituals() { return maintenanceOperations.stopMemoryRituals(this); }
+    restartArtifactRetentionScheduler(artifactDir, reason) { return maintenanceOperations.restartArtifactRetentionScheduler(this, artifactDir, reason); }
+    stopArtifactRetentionScheduler() { return maintenanceOperations.stopArtifactRetentionScheduler(this); }
+    /**
+     * Deliver a native cron/webhook notification to whichever running channel owns
+     * the destination conversationId. With `verbatim`, the channel posts `text`
+     * unchanged (no model call) and records it to history; otherwise it runs `text`
+     * as a turn. Best-effort: an unavailable/unsupported destination is warned and
+     * skipped, never thrown back to the cron/webhook trigger.
+     */
+    async notifyDestination(conversationId, text, options) { return maintenanceOperations.notifyDestination(this, conversationId, text, options); }
+    /**
+     * Candidate destinations for native cron/webhook notification delivery, used to
+     * infer a target when a job/endpoint sets no explicit `notifyConversationId`.
+     */
+    async listNotifyDestinations() { return maintenanceOperations.listNotifyDestinations(this); }
+    async startChannel(driver, reason) { return channelsOperations.startChannel(this, driver, reason); }
+    async stopChannel(id, reason) { return channelsOperations.stopChannel(this, id, reason); }
+    async buildResponder(coreConfig) { return responderOperations.buildResponder(this, coreConfig); }
+    /**
+     * Per-request extension that applies a cron/webhook/tui per-trigger model +
+     * effort override (validated, warn-and-ignore on bad input). Threads the
+     * configured local providers so a LOCAL-model override recomputes its endpoint
+     * block for the OVERRIDE model (see request-model-override doc). Composed
+     * alongside the memory/adapter extensions.
+     */
+    requestModelOverrideRuntimeOptions(coreConfig, compatibility) { return responderOperations.requestModelOverrideRuntimeOptions(this, coreConfig, compatibility); }
+    /**
+     * Memoized factory for runtimes bound to a per-request override model. Reuses
+     * createConfiguredAgentRuntime so the override becomes the fallback-chain
+     * primary with the configured backups after it (override + keep fallbacks).
+     * Built runtimes register in `activeRuntimes`, which is disposed on `stop()`
+     * (config reload rebuilds the responder but does not drain prior runtimes —
+     * same lifetime as the base runtime built in `buildResponder`).
+     */
+    buildRuntimeForModel(coreConfig) { return responderOperations.buildRuntimeForModel(this, coreConfig); }
+    /**
+     * Run-identifying context threaded onto exported spans (Phoenix shows the same
+     * source/run identifiers as the local trace-source registry, so local artifact
+     * lookup stays possible). Resolved with the same source-id/label resolvers the
+     * trace source uses.
+     */
+    async observabilityContext() { return traceabilityOperations.observabilityContext(this); }
+    reportMemoryRecallStatus(coreConfig, service) { return traceabilityOperations.reportMemoryRecallStatus(this, coreConfig, service); }
+    /**
+     * Optional CLOUD-ONLY escape hatch: when `memory.supermemory.exposeMcpServer` is on, ALSO inject
+     * Supermemory's hosted MCP server alongside the in-app `MemoryRecall` tool. The hosted MCP cannot
+     * point at a self-hosted instance, so self-hosters rely on the in-app recall tool; this just adds
+     * the cloud server's richer tools for cloud deployments. Requires an apiKey (skipped + warned if
+     * absent).
+     */
+    supermemoryMcpRuntimeOptions(coreConfig) { return responderOperations.supermemoryMcpRuntimeOptions(this, coreConfig); }
+    async adapterSendToolsRuntimeOptions(coreConfig) { return responderOperations.adapterSendToolsRuntimeOptions(this, coreConfig); }
+    /** Build the configured memory store once and share it across responders + the ritual scheduler. */
+    async memoryStore(coreConfig) { return memoryOperations.memoryStore(this, coreConfig); }
+    /** Close + clear the shared memory store (on config reload or stop) so the next build is fresh. */
+    async resetSharedMemory() { return memoryOperations.resetSharedMemory(this); }
+    /** @internal Test-only seam: seed the shared memory store without going through config. */
+    __setSharedMemoryForTest(store) { return memoryOperations.__setSharedMemoryForTest(this, store); }
+    ensureSharedMemoryRetrieval(coreConfig, store) { return memoryOperations.ensureSharedMemoryRetrieval(this, coreConfig, store); }
+    setStatus(id, status) { return channelsOperations.setStatus(this, id, status); }
+    applyResult() { return channelsOperations.applyResult(this); }
+    async stopTraceSource(reason) { return traceabilityOperations.stopTraceSource(this, reason); }
+    activeTransports() { return channelsOperations.activeTransports(this); }
+    async refreshSelectedSkillsSnapshot(reason) { return traceabilityOperations.refreshSelectedSkillsSnapshot(this, reason); }
+    rememberSelectedSkills(coreConfig) { return traceabilityOperations.rememberSelectedSkills(this, coreConfig); }
+    recordSessionEvent(event, coreConfig) { return traceabilityOperations.recordSessionEvent(this, event, coreConfig); }
+    traceMetadata(reason) { return traceabilityOperations.traceMetadata(this, reason); }
+}
+//# sourceMappingURL=app-controller.js.map

package/dist/app-controller.js.map

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

package/dist/app.d.ts

@@ -1,118 +1,10 @@
-import type { TraceSourceMemoryHealth } from "@mono-agent/observability";
-import type { MonoRuntimeLike } from "@mono-agent/runtime-adapter";
-import type { SandboxEffectiveState, SandboxEngine } from "@mono-agent/runtime-adapter";
-import type { AppTraceDefaults } from "./app-config.js";
-import type { ChannelDriver, ChannelId, ChannelStatus, MonoAgentAppLogger } from "./channels.js";
-import type { ContinuationHealthSnapshot, ContinuationStatusSnapshot } from "./continuations.js";
-import type { BackgroundSnapshot } from "./background-snapshot.js";
 /**
- * Outcome of a live config re-apply (`applyConfigChange`). Consumed by callers
- * that trigger a reload and by demos that surface the result.
+ * Stable config-first host surface.
+ *
+ * The controller implementation lives in `app-controller.ts`; consumers keep
+ * importing `./app.js` while lifecycle collaborators are extracted behind this
+ * boundary in focused, behavior-preserving changes.
  */
-export type ConfigApplyResult = {
-    readonly kind: "applied";
-    readonly message: string;
-    readonly transports: readonly string[];
-} | {
-    readonly kind: "waiting_for_config";
-    readonly message: string;
-    readonly transports: readonly string[];
-} | {
-    readonly kind: "failed";
-    readonly message: string;
-    readonly transports: readonly string[];
-};
-export interface MonoAgentAppOptions {
-    readonly env?: Record<string, string | undefined>;
-    readonly cwd?: string;
-    /** Path to mono-agent.config.json; defaults to <cwd>/mono-agent.config.json. */
-    readonly configPath?: string;
-    /**
-     * Optional immutable read source for managed workers. The public app and
-     * trace metadata continue to identify `configPath`; every runtime/channel
-     * config loader reads this path instead.
-     */
-    readonly configReadPath?: string;
-    readonly logger?: MonoAgentAppLogger;
-    /** Channel drivers to run. Defaults to every built-in channel. */
-    readonly drivers?: readonly ChannelDriver[];
-    /** Shared runtime override (testing / advanced composition). */
-    readonly runtime?: MonoRuntimeLike;
-    /** Sandbox engine override (testing / advanced composition). */
-    readonly sandboxEngine?: SandboxEngine;
-    readonly traceDefaults?: AppTraceDefaults;
-    /** Secret-free proof of the durable files/environment observed by this worker. */
-    readonly backgroundSnapshot?: BackgroundSnapshot;
-}
-export type TraceabilityStatus = {
-    readonly kind: "running";
-    readonly sourceId: string;
-    readonly registryDir: string;
-    readonly artifactDir: string;
-} | {
-    readonly kind: "disabled";
-    readonly reason: string;
-} | {
-    readonly kind: "failed";
-    readonly reason: string;
-};
-/**
- * Best-effort observability exporter status. `configured` does not assert
- * reachability (Phoenix may start later — only `validate` probes); export
- * failures during runs surface as `lastWarning`/`lastError` without changing the
- * run outcome.
- */
-export type ExporterStatus = {
-    readonly kind: "configured";
-    readonly endpoint: string;
-    readonly includeSensitiveData: boolean;
-    readonly lastWarning?: string;
-    readonly lastError?: string;
-} | {
-    readonly kind: "disabled";
-    readonly reason: string;
-} | {
-    readonly kind: "failed";
-    readonly reason: string;
-};
-export interface SandboxStatus extends SandboxEffectiveState {
-    readonly detail: string;
-    readonly warning?: string;
-    readonly resolutionError?: string;
-}
-export interface MonoAgentApp {
-    readonly configPath: string;
-    readonly traceabilityStatus: TraceabilityStatus;
-    readonly exporterStatus: ExporterStatus;
-    readonly sandboxStatus: SandboxStatus;
-    readonly memoryHealth?: TraceSourceMemoryHealth;
-    readonly selectedSkills: readonly string[] | undefined;
-    channelStatus(id: ChannelId): ChannelStatus;
-    channelStatuses(): ReadonlyMap<ChannelId, ChannelStatus>;
-    continuationHealth?(): Promise<ContinuationHealthSnapshot | undefined>;
-    listContinuations?(): Promise<readonly ContinuationStatusSnapshot[]>;
-    capturedContinuationText?(id: string): Promise<string | undefined>;
-    retryContinuation?(id: string, options?: {
-        readonly allowUnknown?: boolean;
-    }): Promise<ContinuationStatusSnapshot>;
-    cancelContinuation?(id: string): Promise<ContinuationStatusSnapshot>;
-    resolveContinuationDelivery?(id: string, outcome: {
-        readonly kind: "delivered";
-        readonly deliveryId?: string;
-    } | {
-        readonly kind: "not_delivered";
-    } | {
-        readonly kind: "dead_lettered";
-    }): Promise<ContinuationStatusSnapshot>;
-    startChannelIfConfigured(id: ChannelId, reason: string): Promise<ChannelStatus>;
-    applyConfigChange(reason: string): Promise<ConfigApplyResult>;
-    stop(): Promise<void>;
-}
-/**
- * Starts a config-first mono-agent host in `cwd`: traceability first, then every
- * configured channel in parallel. Channels with incomplete config report
- * `waiting_for_config` instead of blocking the rest. The host runs headless;
- * config changes take effect on the next restart.
- */
-export declare function startMonoAgentApp(options?: MonoAgentAppOptions): Promise<MonoAgentApp>;
+export { startMonoAgentApp } from "./app-controller.js";
+export type { ConfigApplyResult, ExporterStatus, MonoAgentApp, MonoAgentAppOptions, SandboxStatus, TraceabilityStatus, } from "./app-controller.js";
 //# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,kBAAkB,GACnB,MAAM,qBAAqB,CAAC"}