paracosm 0.7.409 → 0.7.443

package/dist/cli/server/run-history-store.js

@@ -3,6 +3,11 @@ export function createNoopRunHistoryStore() {
         async insertRun() { },
         async listRuns() { return []; },
         async getRun() { return null; },
+        async countRuns() { return 0; },
+        async aggregateStats() {
+            return { totalRuns: 0, totalCostUSD: 0, totalDurationMs: 0, replaysAttempted: 0, replaysMatched: 0 };
+        },
+        async recordReplayResult() { },
     };
 }
 //# sourceMappingURL=run-history-store.js.map

package/dist/cli/server/run-history-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-history-store.js","sourceRoot":"","sources":["../../../src/cli/server/run-history-store.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,yBAAyB;IACvC,OAAO;QACL,KAAK,CAAC,SAAS,KAAI,CAAC;QACpB,KAAK,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC;QAC/B,KAAK,CAAC,MAAM,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC;KAChC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"run-history-store.js","sourceRoot":"","sources":["../../../src/cli/server/run-history-store.ts"],"names":[],"mappings":"AAoCA,MAAM,UAAU,yBAAyB;IACvC,OAAO;QACL,KAAK,CAAC,SAAS,KAAI,CAAC;QACpB,KAAK,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC;QAC/B,KAAK,CAAC,MAAM,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC;QAC/B,KAAK,CAAC,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;QAC/B,KAAK,CAAC,cAAc;YAClB,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;QACvG,CAAC;QACD,KAAK,CAAC,kBAAkB,KAAI,CAAC;KAC9B,CAAC;AACJ,CAAC"}

package/dist/cli/server/run-record.d.ts

@@ -8,6 +8,19 @@ export interface RunRecord {
     economicsProfile: string;
     sourceMode: ParacosmServerMode;
     createdBy: 'anonymous' | 'user' | 'service';
+    /** Absolute path to the on-disk RunArtifact JSON. Undefined for legacy
+     *  runs whose path was not preserved. New runs always populate this. */
+    artifactPath?: string;
+    /** Total cost in USD captured from artifact.cost.totalUSD at insert time. */
+    costUSD?: number;
+    /** Wall-clock duration of the run in milliseconds. */
+    durationMs?: number;
+    /** Simulation mode captured from artifact.metadata.mode. */
+    mode?: 'turn-loop' | 'batch-trajectory' | 'batch-point';
+    /** Captured leader display name for the gallery card. */
+    leaderName?: string;
+    /** Captured leader archetype for the gallery card. */
+    leaderArchetype?: string;
 }
 export declare function createRunRecord(input: Omit<RunRecord, 'runId' | 'createdAt'>): RunRecord;
 export declare function hashLeaderConfig(input: unknown): string;

package/dist/cli/server/run-record.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-record.d.ts","sourceRoot":"","sources":["../../../src/cli/server/run-record.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,SAAS,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;CAC7C;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,WAAW,CAAC,GAAG,SAAS,CAMxF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEvD"}
+{"version":3,"file":"run-record.d.ts","sourceRoot":"","sources":["../../../src/cli/server/run-record.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,SAAS,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;IAC5C;4EACwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,WAAW,GAAG,kBAAkB,GAAG,aAAa,CAAC;IACxD,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,WAAW,CAAC,GAAG,SAAS,CAMxF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEvD"}

package/dist/cli/server/run-record.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-record.js","sourceRoot":"","sources":["../../../src/cli/server/run-record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAcrD,MAAM,UAAU,eAAe,CAAC,KAA6C;IAC3E,OAAO;QACL,KAAK,EAAE,OAAO,UAAU,EAAE,EAAE;QAC5B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,GAAG,KAAK;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,WAAW,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AACpG,CAAC"}
+{"version":3,"file":"run-record.js","sourceRoot":"","sources":["../../../src/cli/server/run-record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA2BrD,MAAM,UAAU,eAAe,CAAC,KAA6C;IAC3E,OAAO;QACL,KAAK,EAAE,OAAO,UAAU,EAAE,EAAE;QAC5B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,GAAG,KAAK;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,WAAW,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AACpG,CAAC"}

package/dist/cli/server/sqlite-run-history-store.d.ts

@@ -0,0 +1,6 @@
+import type { RunHistoryStore } from './run-history-store.js';
+export interface SqliteRunHistoryStoreOptions {
+    dbPath: string;
+}
+export declare function createSqliteRunHistoryStore(options: SqliteRunHistoryStoreOptions): RunHistoryStore;
+//# sourceMappingURL=sqlite-run-history-store.d.ts.map

package/dist/cli/server/sqlite-run-history-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-run-history-store.d.ts","sourceRoot":"","sources":["../../../src/cli/server/sqlite-run-history-store.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAmB,eAAe,EAAiB,MAAM,wBAAwB,CAAC;AAE9F,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,MAAM,CAAC;CAChB;AAmFD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,4BAA4B,GAAG,eAAe,CA6JlG"}

package/dist/cli/server/sqlite-run-history-store.js

@@ -0,0 +1,226 @@
+/**
+ * SQLite-backed implementation of {@link RunHistoryStore}. Mirrors the
+ * session-store pattern: better-sqlite3, WAL mode, prepared statements,
+ * `:memory:` path support for clean test isolation.
+ *
+ * Single `runs` table with composite per-filter indexes. Run records are
+ * tiny (~200 bytes); 100K rows fits in 20 MB. No retention cap; add
+ * `PARACOSM_RUN_HISTORY_MAX_ROWS` env var if traffic ever warrants it.
+ *
+ * @module paracosm/cli/server/sqlite-run-history-store
+ */
+import Database from 'better-sqlite3';
+import { mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+const DEFAULT_LIMIT = 50;
+const MAX_LIMIT = 500;
+function clampLimit(raw) {
+    if (raw === undefined || !Number.isFinite(raw) || raw <= 0)
+        return DEFAULT_LIMIT;
+    return Math.min(MAX_LIMIT, Math.floor(raw));
+}
+function clampOffset(raw) {
+    if (raw === undefined || !Number.isFinite(raw) || raw < 0)
+        return 0;
+    return Math.floor(raw);
+}
+function rowToRecord(row) {
+    // Omit undefined optional fields so deepEqual against records constructed
+    // without those fields succeeds. Spread only when value is non-null.
+    const record = {
+        runId: row.run_id,
+        createdAt: row.created_at,
+        scenarioId: row.scenario_id,
+        scenarioVersion: row.scenario_version,
+        leaderConfigHash: row.leader_config_hash,
+        economicsProfile: row.economics_profile,
+        sourceMode: row.source_mode,
+        createdBy: row.created_by,
+    };
+    if (row.artifact_path !== null)
+        record.artifactPath = row.artifact_path;
+    if (row.cost_usd !== null)
+        record.costUSD = row.cost_usd;
+    if (row.duration_ms !== null)
+        record.durationMs = row.duration_ms;
+    if (row.mode !== null)
+        record.mode = row.mode;
+    if (row.leader_name !== null)
+        record.leaderName = row.leader_name;
+    if (row.leader_archetype !== null)
+        record.leaderArchetype = row.leader_archetype;
+    return record;
+}
+/**
+ * Idempotent column-add migration. SQLite raises "duplicate column name"
+ * when the column already exists; we swallow that and propagate any other
+ * error. Called from the schema bootstrap on every store creation; safe
+ * to run repeatedly.
+ */
+function ensureRunsColumns(db) {
+    const newCols = [
+        ['artifact_path', 'TEXT'],
+        ['cost_usd', 'REAL'],
+        ['duration_ms', 'INTEGER'],
+        ['mode', 'TEXT'],
+        ['leader_name', 'TEXT'],
+        ['leader_archetype', 'TEXT'],
+        ['replay_attempts', 'INTEGER DEFAULT 0'],
+        ['replay_matches', 'INTEGER DEFAULT 0'],
+    ];
+    for (const [name, type] of newCols) {
+        try {
+            db.exec(`ALTER TABLE runs ADD COLUMN ${name} ${type};`);
+        }
+        catch (err) {
+            const msg = String(err.message ?? err);
+            if (!msg.includes('duplicate column name'))
+                throw err;
+        }
+    }
+}
+export function createSqliteRunHistoryStore(options) {
+    const { dbPath } = options;
+    if (dbPath !== ':memory:')
+        mkdirSync(dirname(dbPath), { recursive: true });
+    const db = new Database(dbPath);
+    db.pragma('journal_mode = WAL');
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS runs (
+      run_id              TEXT PRIMARY KEY NOT NULL,
+      created_at          TEXT NOT NULL,
+      scenario_id         TEXT NOT NULL,
+      scenario_version    TEXT NOT NULL,
+      leader_config_hash  TEXT NOT NULL,
+      economics_profile   TEXT NOT NULL,
+      source_mode         TEXT NOT NULL,
+      created_by          TEXT NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_runs_created_at        ON runs (created_at DESC);
+    CREATE INDEX IF NOT EXISTS idx_runs_scenario_created  ON runs (scenario_id, created_at DESC);
+    CREATE INDEX IF NOT EXISTS idx_runs_leader_created    ON runs (leader_config_hash, created_at DESC);
+    CREATE INDEX IF NOT EXISTS idx_runs_mode_created      ON runs (source_mode, created_at DESC);
+  `);
+    ensureRunsColumns(db);
+    // Index for filtering by simulation mode (Library tab).
+    try {
+        db.exec(`CREATE INDEX IF NOT EXISTS idx_runs_sim_mode_created ON runs (mode, created_at DESC);`);
+    }
+    catch (err) {
+        // Index creation may fail if mode column was just added; ignore.
+        void err;
+    }
+    const insertStmt = db.prepare(`
+    INSERT OR IGNORE INTO runs
+      (run_id, created_at, scenario_id, scenario_version, leader_config_hash,
+       economics_profile, source_mode, created_by,
+       artifact_path, cost_usd, duration_ms, mode, leader_name, leader_archetype)
+    VALUES
+      (@runId, @createdAt, @scenarioId, @scenarioVersion, @leaderConfigHash,
+       @economicsProfile, @sourceMode, @createdBy,
+       @artifactPath, @costUSD, @durationMs, @mode, @leaderName, @leaderArchetype)
+  `);
+    function insertRowParams(run) {
+        return {
+            runId: run.runId,
+            createdAt: run.createdAt,
+            scenarioId: run.scenarioId,
+            scenarioVersion: run.scenarioVersion,
+            leaderConfigHash: run.leaderConfigHash,
+            economicsProfile: run.economicsProfile,
+            sourceMode: run.sourceMode,
+            createdBy: run.createdBy,
+            artifactPath: run.artifactPath ?? null,
+            costUSD: run.costUSD ?? null,
+            durationMs: run.durationMs ?? null,
+            mode: run.mode ?? null,
+            leaderName: run.leaderName ?? null,
+            leaderArchetype: run.leaderArchetype ?? null,
+        };
+    }
+    const getStmt = db.prepare(`SELECT * FROM runs WHERE run_id = ?`);
+    function buildWhere(filters) {
+        const clauses = [];
+        const params = {};
+        // Simulation mode filter (artifact.metadata.mode column).
+        if (filters?.mode) {
+            clauses.push('mode = @mode');
+            params.mode = filters.mode;
+        }
+        // Server source mode filter (source_mode column). Distinct from above.
+        if (filters?.sourceMode) {
+            clauses.push('source_mode = @sourceMode');
+            params.sourceMode = filters.sourceMode;
+        }
+        if (filters?.scenarioId) {
+            clauses.push('scenario_id = @scenarioId');
+            params.scenarioId = filters.scenarioId;
+        }
+        if (filters?.leaderConfigHash) {
+            clauses.push('leader_config_hash = @leaderConfigHash');
+            params.leaderConfigHash = filters.leaderConfigHash;
+        }
+        if (filters?.q) {
+            clauses.push('(scenario_id LIKE @q OR leader_name LIKE @q OR leader_archetype LIKE @q)');
+            params.q = `%${filters.q}%`;
+        }
+        return {
+            where: clauses.length > 0 ? `WHERE ${clauses.join(' AND ')}` : '',
+            params,
+        };
+    }
+    return {
+        async insertRun(run) {
+            insertStmt.run(insertRowParams(run));
+        },
+        async listRuns(filters) {
+            const { where, params } = buildWhere(filters);
+            const limit = clampLimit(filters?.limit);
+            const offset = clampOffset(filters?.offset);
+            const sql = `SELECT * FROM runs ${where} ORDER BY created_at DESC LIMIT @__limit OFFSET @__offset`;
+            const rows = db
+                .prepare(sql)
+                .all({ ...params, __limit: limit, __offset: offset });
+            return rows.map(rowToRecord);
+        },
+        async getRun(runId) {
+            const row = getStmt.get(runId);
+            return row ? rowToRecord(row) : null;
+        },
+        async countRuns(filters) {
+            const { where, params } = buildWhere(filters);
+            const sql = `SELECT COUNT(*) AS n FROM runs ${where}`;
+            const row = db.prepare(sql).get(params);
+            return row?.n ?? 0;
+        },
+        async aggregateStats(filters) {
+            const { where, params } = buildWhere(filters);
+            const sql = `
+        SELECT
+          COUNT(*)                         AS total_runs,
+          COALESCE(SUM(cost_usd), 0)       AS total_cost_usd,
+          COALESCE(SUM(duration_ms), 0)    AS total_duration_ms,
+          COALESCE(SUM(replay_attempts), 0) AS replays_attempted,
+          COALESCE(SUM(replay_matches), 0)  AS replays_matched
+        FROM runs ${where}
+      `;
+            const row = db.prepare(sql).get(params);
+            return {
+                totalRuns: Number(row?.total_runs ?? 0),
+                totalCostUSD: Number(row?.total_cost_usd ?? 0),
+                totalDurationMs: Number(row?.total_duration_ms ?? 0),
+                replaysAttempted: Number(row?.replays_attempted ?? 0),
+                replaysMatched: Number(row?.replays_matched ?? 0),
+            };
+        },
+        async recordReplayResult(runId, matches) {
+            db.prepare(`
+        UPDATE runs
+        SET replay_attempts = COALESCE(replay_attempts, 0) + 1,
+            replay_matches  = COALESCE(replay_matches, 0) + ?
+        WHERE run_id = ?
+      `).run(matches ? 1 : 0, runId);
+        },
+    };
+}
+//# sourceMappingURL=sqlite-run-history-store.js.map

package/dist/cli/server/sqlite-run-history-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-run-history-store.js","sourceRoot":"","sources":["../../../src/cli/server/sqlite-run-history-store.ts"],"names":[],"mappings":"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"}

package/dist/cli/server-app.d.ts

@@ -6,7 +6,7 @@ import { type SessionStore } from './session-store.js';
 import { type RunHistoryStore } from './server/run-history-store.js';
 export interface CreateMarsServerOptions {
     env?: NodeJS.ProcessEnv;
-    runPairSimulations?: (config: NormalizedSimulationConfig, broadcast: BroadcastFn, signal?: AbortSignal, scenario?: ScenarioPackage) => Promise<void>;
+    runPairSimulations?: (config: NormalizedSimulationConfig, broadcast: BroadcastFn, signal?: AbortSignal, scenario?: ScenarioPackage, onArtifact?: (artifact: import('../engine/schema/index.js').RunArtifact, leader: import('../runtime/orchestrator.js').LeaderConfig) => void | Promise<void>) => Promise<void>;
     generateText?: (args: {
         provider: string;
         model: string;
@@ -38,9 +38,80 @@ export interface CreateMarsServerOptions {
      */
     sessionStore?: SessionStore;
     runHistoryStore?: RunHistoryStore;
+    /** Maximum accepted HTTP request body size. Defaults to 5 MiB. */
+    maxRequestBodyBytes?: number;
+}
+/**
+ * Optional hooks the /setup handler can pass to startWithConfig so that
+ * per-artifact post-flight work (Library-tab record persistence, future
+ * webhook notifications, etc.) can run with /setup-handler scope (which
+ * is where hasUserKeys, the runRecord base, and the active scenario
+ * already live).
+ */
+export interface StartConfigHooks {
+    /**
+     * Fired once per completed leader artifact. Failures inside the hook
+     * are caught and logged by the runner; they do not abort the run.
+     */
+    onArtifact?: (artifact: import('../engine/schema/index.js').RunArtifact, leader: import('../runtime/orchestrator.js').LeaderConfig) => void | Promise<void>;
 }
 export interface MarsServer extends Server {
-    startWithConfig: (config: NormalizedSimulationConfig) => Promise<void>;
+    startWithConfig: (config: NormalizedSimulationConfig, hooks?: StartConfigHooks) => Promise<void>;
 }
+export declare function buildResultsPayloadFromEventBuffer(eventBuffer: readonly string[]): {
+    results: any[];
+    verdict: any;
+    isComplete: boolean;
+    turnsCompleted: number;
+    totalEvents: number;
+    leaders: {
+        events: Array<{
+            turn?: number;
+            time?: number;
+            eventIndex?: number;
+            title?: string;
+            category?: string;
+            description?: string;
+            emergent?: boolean;
+        }>;
+        decisions: Array<{
+            turn?: number;
+            time?: number;
+            eventIndex?: number;
+            decision?: string;
+            rationale?: string;
+            selectedPolicies?: unknown[];
+            outcome?: string;
+        }>;
+        forges: Array<Record<string, unknown>>;
+        citations: Array<{
+            text?: string;
+            url?: string;
+            doi?: string;
+            department?: string;
+            turn?: number;
+        }>;
+        deptReports: Array<{
+            turn?: number;
+            time?: number;
+            eventIndex?: number;
+            department?: string;
+            summary?: string;
+            risks?: unknown[];
+            recommendedActions?: unknown[];
+            citations?: number;
+            toolCount?: number;
+        }>;
+        agentReactions: Array<{
+            turn?: number;
+            time?: number;
+            reactions?: unknown[];
+            totalReactions?: number;
+        }>;
+        promotions: Array<Record<string, unknown>>;
+        systemsSnapshots: Array<Record<string, unknown>>;
+        name: string;
+    }[];
+};
 export declare function createMarsServer(options?: CreateMarsServerOptions): MarsServer;
 //# sourceMappingURL=server-app.d.ts.map

package/dist/cli/server-app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-app.d.ts","sourceRoot":"","sources":["../../src/cli/server-app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,MAAM,EAAuB,MAAM,WAAW,CAAC;AAIjG,OAAO,EAA4C,KAAK,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC5G,OAAO,EAAyC,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG3F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAkB1D,OAAO,EAAoB,KAAK,YAAY,EAAyB,MAAM,oBAAoB,CAAC;AAIhG,OAAO,EAA6B,KAAK,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAwDhG,MAAM,WAAW,uBAAuB;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,0BAA0B,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrJ,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxG,eAAe,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACxH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6FAA6F;IAC7F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,MAAM,WAAW,UAAW,SAAQ,MAAM;IACxC,eAAe,EAAE,CAAC,MAAM,EAAE,0BAA0B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,UAAU,CA0yDlF"}
+{"version":3,"file":"server-app.d.ts","sourceRoot":"","sources":["../../src/cli/server-app.ts"],"names":[],"mappings":"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"}