@senpi/runtime 1.0.95-dev.20260408174401

package/dist/runtime/recipe-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-version.d.ts","sourceRoot":"","sources":["../../src/runtime/recipe-version.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,OAAO,EACL,uBAAuB,IAAI,sBAAsB,EACjD,0BAA0B,IAAI,yBAAyB,EACvD,mBAAmB,GACpB,MAAM,sBAAsB,CAAC"}

package/dist/runtime/recipe-version.js

@@ -0,0 +1,3 @@
+/** @deprecated Import from ./runtime-version.ts instead. */
+export { CURRENT_RUNTIME_VERSION as CURRENT_RECIPE_VERSION, SUPPORTED_RUNTIME_VERSIONS as SUPPORTED_RECIPE_VERSIONS, extractMajorVersion, } from "./runtime-version.js";
+//# sourceMappingURL=recipe-version.js.map

package/dist/runtime/recipe-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-version.js","sourceRoot":"","sources":["../../src/runtime/recipe-version.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,OAAO,EACL,uBAAuB,IAAI,sBAAsB,EACjD,0BAA0B,IAAI,yBAAyB,EACvD,mBAAmB,GACpB,MAAM,sBAAsB,CAAC"}

package/dist/runtime/reconcile-state.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Post-hydrate reconciliation: align StateManager DSL state with backend (Senpi/MCP) open positions.
+ * Best-effort: on backend failure for an address, we skip that address entirely (do not archive).
+ */
+import type { StateManager } from "../state/index.js";
+import type { SenpiClient } from "../senpi/client.js";
+import type { StrategyConfig, StrategyState } from "../types/strategy.js";
+import type { SenpiEventBus } from "../types/event-bus.js";
+export interface ReconcileOptions {
+    /** If provided, emit POSITION_CLOSED when a position is archived (e.g. from DSL monitor). */
+    bus?: SenpiEventBus;
+    /**
+     * When set, open positions per address are read from StrategyState.getOpenPositions() instead of
+     * listOpenPositions (unless {@link strategyStateOnly} is false and an address is missing from the map).
+     * Caller must refresh via fetchClearinghouseState before reconcile when using cached positions.
+     */
+    strategyStates?: Map<string, StrategyState>;
+    /**
+     * When true (DSL monitor tick), reconciliation uses only StrategyState: no SenpiClient.listOpenPositions
+     * or getOrderStatus fallbacks. Addresses without a map entry are skipped (no archive for that wallet).
+     */
+    strategyStateOnly?: boolean;
+}
+/**
+ * Reconcile state with backend: fetch open positions per address via `SenpiClient.listOpenPositions`
+ * (parses `strategy_get_clearinghouse_state`, not `list_open_positions`) and archive local DSL state
+ * for positions that are no longer on the exchange (e.g. closed manually externally).
+ * Only archives positions for addresses where clearing-house fetch succeeded; if the API throws
+ * or is unavailable for an address, we do not archive any position for that address.
+ *
+ * Call after hydrate() in Runtime.start() and periodically from the DSL monitor tick.
+ *
+ * @param addresses - strategy addresses to reconcile
+ * @param options - optional bus to emit POSITION_CLOSED when archiving (e.g. from monitor)
+ */
+export declare function reconcileStateWithBackend(stateManager: StateManager, senpi: SenpiClient, addressesOrStrategiesMap: string[] | Map<string, StrategyConfig>, options?: ReconcileOptions): Promise<void>;
+//# sourceMappingURL=reconcile-state.d.ts.map

package/dist/runtime/reconcile-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile-state.d.ts","sourceRoot":"","sources":["../../src/runtime/reconcile-state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAuD3D,MAAM,WAAW,gBAAgB;IAC/B,6FAA6F;IAC7F,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB;;;;OAIG;IACH,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC5C;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,yBAAyB,CAC7C,YAAY,EAAE,YAAY,EAC1B,KAAK,EAAE,WAAW,EAClB,wBAAwB,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EAChE,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,IAAI,CAAC,CA0Hf"}

package/dist/runtime/reconcile-state.js

@@ -0,0 +1,179 @@
+/**
+ * Post-hydrate reconciliation: align StateManager DSL state with backend (Senpi/MCP) open positions.
+ * Best-effort: on backend failure for an address, we skip that address entirely (do not archive).
+ */
+import { CLOSE_REASON, DSL_EXTERNAL_RETRIES, DSL_EXTERNAL_RETRY_DELAY_MS } from "../constants/dsl/index.js";
+import { EVENTS } from "../constants/dsl/index.js";
+import { createLogger } from "../utils/logger.js";
+import { withRetry } from "../utils/retry.js";
+const logger = createLogger("[senpi-core][reconcile]");
+function positionKey(address, asset, dex) {
+    return `${address}:${asset}:${dex ?? ""}`;
+}
+async function resolveMissingPositionCloseReason(senpi, state, strategyState, strategyStateOnly) {
+    const slOrderId = state.slOrderId;
+    if (slOrderId == null)
+        return CLOSE_REASON.CLOSED_EXTERNALLY;
+    try {
+        const status = await withRetry(() => {
+            if (strategyState)
+                return strategyState.getOrderStatus(slOrderId);
+            if (strategyStateOnly)
+                return Promise.resolve(null);
+            return senpi.getOrderStatus(state.wallet, slOrderId);
+        }, {
+            retries: DSL_EXTERNAL_RETRIES,
+            delayMs: DSL_EXTERNAL_RETRY_DELAY_MS,
+            label: "reconcileOrderStatus",
+            onRetry: (attempt, remaining, err) => logger.warn("reconcile: getOrderStatus retry", {
+                address: state.address,
+                asset: state.asset,
+                slOrderId,
+                attempt,
+                remaining,
+                err,
+            }),
+        });
+        if (status?.filled)
+            return CLOSE_REASON.EXCHANGE_SL_HIT;
+    }
+    catch (err) {
+        logger.warn("reconcile: getOrderStatus failed while classifying missing position", {
+            address: state.address,
+            asset: state.asset,
+            slOrderId,
+            err,
+        });
+    }
+    return CLOSE_REASON.CLOSED_EXTERNALLY;
+}
+/**
+ * Reconcile state with backend: fetch open positions per address via `SenpiClient.listOpenPositions`
+ * (parses `strategy_get_clearinghouse_state`, not `list_open_positions`) and archive local DSL state
+ * for positions that are no longer on the exchange (e.g. closed manually externally).
+ * Only archives positions for addresses where clearing-house fetch succeeded; if the API throws
+ * or is unavailable for an address, we do not archive any position for that address.
+ *
+ * Call after hydrate() in Runtime.start() and periodically from the DSL monitor tick.
+ *
+ * @param addresses - strategy addresses to reconcile
+ * @param options - optional bus to emit POSITION_CLOSED when archiving (e.g. from monitor)
+ */
+export async function reconcileStateWithBackend(stateManager, senpi, addressesOrStrategiesMap, options) {
+    const { bus, strategyStateOnly = false } = options ?? {};
+    const addresses = addressesOrStrategiesMap instanceof Map
+        ? Array.from(addressesOrStrategiesMap.keys())
+        : addressesOrStrategiesMap;
+    const backendPositionKeys = new Set();
+    const successfullyFetchedAddresses = new Set();
+    await Promise.all(addresses.map(async (address) => {
+        const strategy = options?.strategyStates?.get(address);
+        if (strategyStateOnly) {
+            if (!strategy) {
+                logger.warn("reconcile: no StrategyState for address, skipping wallet (strategyStateOnly)", {
+                    address,
+                });
+                return;
+            }
+            const positions = strategy.getOpenPositions();
+            if (positions == undefined) {
+                // Clearinghouse state was never successfully fetched for this address — skip rather than
+                // treating it as "no positions", which would incorrectly archive all active DSL state.
+                logger.warn("reconcile: getOpenPositions returned null/undefined (clearinghouse not fetched), skipping wallet", {
+                    address,
+                });
+                return;
+            }
+            successfullyFetchedAddresses.add(address);
+            for (const p of positions) {
+                const coin = p.coin ?? "";
+                const dex = p.dex ?? "";
+                if (coin)
+                    backendPositionKeys.add(positionKey(address, coin, dex));
+            }
+            return;
+        }
+        if (strategy) {
+            const positions = strategy.getOpenPositions() ?? [];
+            successfullyFetchedAddresses.add(address);
+            for (const p of positions) {
+                const coin = p.coin ?? "";
+                const dex = p.dex ?? "";
+                if (coin)
+                    backendPositionKeys.add(positionKey(address, coin, dex));
+            }
+            return;
+        }
+        try {
+            const positions = await withRetry(() => senpi.listOpenPositions(address), {
+                retries: DSL_EXTERNAL_RETRIES,
+                delayMs: DSL_EXTERNAL_RETRY_DELAY_MS,
+                label: "clearingHouseOpenPositions",
+                onRetry: (attempt, remaining, err) => logger.warn("reconcile: clearing house open positions retry", { address, attempt, remaining, err }),
+            });
+            successfullyFetchedAddresses.add(address);
+            for (const p of positions) {
+                const coin = p.coin ?? "";
+                const dex = p.dex ?? "";
+                if (coin)
+                    backendPositionKeys.add(positionKey(address, coin, dex));
+            }
+        }
+        catch (err) {
+            logger.warn("reconcile: clearing house positions fetch failed, skipping wallet (no positions archived)", {
+                address,
+                err,
+            });
+        }
+    }));
+    logger.debug("reconcile: backend positions collected", {
+        backendPositionKeysCount: backendPositionKeys.size,
+        successfullyFetchedCount: successfullyFetchedAddresses.size,
+    });
+    const strategyIds = await stateManager.listStrategyIds();
+    const ts = new Date().toISOString();
+    for (const address of strategyIds) {
+        const keys = await stateManager.listDslKeys(`${address}/`);
+        for (const key of keys) {
+            const state = await stateManager.getOrLoad(key);
+            if (!state?.active)
+                continue;
+            if (!successfullyFetchedAddresses.has(state.address))
+                continue;
+            const dex = state.dex ?? "";
+            const pk = positionKey(state.address, state.asset, dex);
+            if (backendPositionKeys.has(pk))
+                continue;
+            try {
+                const archivedCloseReason = await resolveMissingPositionCloseReason(senpi, state, options?.strategyStates?.get(state.address), strategyStateOnly);
+                const closedState = {
+                    ...state,
+                    active: false,
+                    closedAt: ts,
+                    closeReason: archivedCloseReason,
+                };
+                await stateManager.archiveAndDeleteDslState(state.address, state.asset, dex, closedState);
+                logger.info("reconcile: archived DSL state (position no longer on backend)", {
+                    address: state.address,
+                    asset: state.asset,
+                    closeReason: archivedCloseReason,
+                });
+                if (bus) {
+                    const tsEmit = new Date().toISOString();
+                    bus.emit(EVENTS.POSITION_CLOSED, {
+                        address: state.address,
+                        asset: state.asset,
+                        wallet: state.wallet,
+                        reason: archivedCloseReason,
+                        closeReason: archivedCloseReason,
+                        timestamp: tsEmit,
+                    });
+                }
+            }
+            catch (err) {
+                logger.warn("reconcile: failed to archive state", { key, err });
+            }
+        }
+    }
+}
+//# sourceMappingURL=reconcile-state.js.map

package/dist/runtime/reconcile-state.js.map

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

package/dist/runtime/risk-guard.d.ts

@@ -0,0 +1,6 @@
+/**
+ * RiskGuard: gate check and record entry (stub - gate always OPEN, record no-op).
+ */
+import type { RiskGuard as IRiskGuard } from "../types/action.js";
+export declare function createRiskGuard(): IRiskGuard;
+//# sourceMappingURL=risk-guard.d.ts.map

package/dist/runtime/risk-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk-guard.d.ts","sourceRoot":"","sources":["../../src/runtime/risk-guard.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAmB,SAAS,IAAI,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEnF,wBAAgB,eAAe,IAAI,UAAU,CAS5C"}

package/dist/runtime/risk-guard.js

@@ -0,0 +1,14 @@
+/**
+ * RiskGuard: gate check and record entry (stub - gate always OPEN, record no-op).
+ */
+export function createRiskGuard() {
+    return {
+        checkGate(_address, _guardRails) {
+            return { gate: "OPEN" };
+        },
+        recordEntry(_address, _guardRails) {
+            // no-op
+        },
+    };
+}
+//# sourceMappingURL=risk-guard.js.map

package/dist/runtime/risk-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk-guard.js","sourceRoot":"","sources":["../../src/runtime/risk-guard.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,SAAS,CAAC,QAAgB,EAAE,WAAqC;YAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC1B,CAAC;QACD,WAAW,CAAC,QAAgB,EAAE,WAAqC;YACjE,QAAQ;QACV,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/runtime/run.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Programmatic entry: load trading recipe and start runtime. Returns handle with stop().
+ */
+import type { McpTransport } from "../senpi/types.js";
+import type { RuntimeHealthStatus, RuntimeSystemState } from "../health/index.js";
+import type { ScannerDataProviders } from "../scanners/engine/data-providers.js";
+import type { DslPlugin } from "../dsl/plugin/index.js";
+export interface RunOptions {
+    fromPath?: boolean;
+    stateDir?: string;
+    mcpTransport?: McpTransport;
+    apiKey?: string;
+    scannerProviders?: ScannerDataProviders;
+}
+export interface RuntimeHandle {
+    stop(): Promise<void>;
+    dsl: DslPlugin | null;
+    /** Wallet address from the recipe's strategy block. */
+    wallet: string;
+    getHealthStatus(): Promise<RuntimeHealthStatus | null>;
+    getSystemState(): Promise<RuntimeSystemState | null>;
+    /** Cancel exchange SLs and archive DSL state for all strategies before deleting a runtime. */
+    teardownDslForRuntimeDeletion(): Promise<void>;
+}
+/**
+ * Load trading recipe from path or content, create Runtime, start it, and return a handle with stop().
+ * Programmatic API used by the OpenClaw adapter and standalone CLI.
+ */
+export declare function run(recipePathOrContent: string, options?: RunOptions): Promise<RuntimeHandle>;
+//# sourceMappingURL=run.d.ts.map

package/dist/runtime/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/runtime/run.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAKxD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;CACzC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IACtB,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IAEf,eAAe,IAAI,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;IACvD,cAAc,IAAI,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IACrD,8FAA8F;IAC9F,6BAA6B,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED;;;GAGG;AACH,wBAAsB,GAAG,CACvB,mBAAmB,EAAE,MAAM,EAC3B,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,aAAa,CAAC,CAmCxB"}

package/dist/runtime/run.js

@@ -0,0 +1,46 @@
+/**
+ * Programmatic entry: load trading recipe and start runtime. Returns handle with stop().
+ */
+import { getDefaultStateDir } from "./default-state-dir.js";
+import { loadRuntimeConfig } from "./load-runtime-config.js";
+import { Runtime } from "./runtime.js";
+/**
+ * Load trading recipe from path or content, create Runtime, start it, and return a handle with stop().
+ * Programmatic API used by the OpenClaw adapter and standalone CLI.
+ */
+export async function run(recipePathOrContent, options) {
+    const fromPath = options?.fromPath === true;
+    const config = await loadRuntimeConfig(recipePathOrContent, { fromPath });
+    const stateDir = (typeof options?.stateDir === "string" && options.stateDir.length > 0)
+        ? options.stateDir
+        : getDefaultStateDir();
+    const mcpTransport = options?.mcpTransport;
+    const apiKey = options?.apiKey;
+    if (!mcpTransport && !apiKey) {
+        throw new Error("run() requires mcpTransport or apiKey for full operation");
+    }
+    const runtime = new Runtime(config, {
+        stateDir,
+        mcpTransport,
+        apiKey,
+        scannerProviders: options?.scannerProviders,
+    });
+    await runtime.start();
+    return {
+        async stop() {
+            await runtime.stop();
+        },
+        dsl: runtime.dsl,
+        wallet: config.strategy?.wallet ?? "",
+        async getHealthStatus() {
+            return runtime.getHealthStatus();
+        },
+        async getSystemState() {
+            return runtime.getSystemState();
+        },
+        teardownDslForRuntimeDeletion() {
+            return runtime.teardownDslForRuntimeDeletion();
+        },
+    };
+}
+//# sourceMappingURL=run.js.map

package/dist/runtime/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/runtime/run.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAsBvC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,mBAA2B,EAC3B,OAAoB;IAEpB,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC5C,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,mBAAmB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC1E,MAAM,QAAQ,GACZ,CAAC,OAAO,OAAO,EAAE,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QACpE,CAAC,CAAC,OAAO,CAAC,QAAQ;QAClB,CAAC,CAAC,kBAAkB,EAAE,CAAC;IAC3B,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,CAAC;IAC3C,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;IAC/B,IAAI,CAAC,YAAY,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE;QAClC,QAAQ;QACR,YAAY;QACZ,MAAM;QACN,gBAAgB,EAAE,OAAO,EAAE,gBAAgB;KAC5C,CAAC,CAAC;IACH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACtB,OAAO;QACL,KAAK,CAAC,IAAI;YACR,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;QACD,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE;QACrC,KAAK,CAAC,eAAe;YACnB,OAAO,OAAO,CAAC,eAAe,EAAE,CAAC;QACnC,CAAC;QACD,KAAK,CAAC,cAAc;YAClB,OAAO,OAAO,CAAC,cAAc,EAAE,CAAC;QAClC,CAAC;QACD,6BAA6B;YAC3B,OAAO,OAAO,CAAC,6BAA6B,EAAE,CAAC;QACjD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/runtime/runtime-config.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Re-export runtime config types from the Zod schema.
+ */
+export type { RuntimeConfig, RuntimeStrategy, RuntimeScanner, RuntimeAction, RuntimeExit, } from "./runtime-schema.js";
+export { runtimeConfigSchema } from "./runtime-schema.js";
+//# sourceMappingURL=runtime-config.d.ts.map

package/dist/runtime/runtime-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-config.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,aAAa,EACb,eAAe,EACf,cAAc,EACd,aAAa,EACb,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/runtime/runtime-config.js

@@ -0,0 +1,5 @@
+/**
+ * Re-export runtime config types from the Zod schema.
+ */
+export { runtimeConfigSchema } from "./runtime-schema.js";
+//# sourceMappingURL=runtime-config.js.map

package/dist/runtime/runtime-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-config.js","sourceRoot":"","sources":["../../src/runtime/runtime-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}