@cats-inc/cats-platform 0.1.0

package/build/server/app/server/startup.d.ts

@@ -0,0 +1,87 @@
+export declare function resolveAppPackageJsonPath(moduleUrl?: string): string;
+export declare const APP_SERVICE_NAME = "cats-platform";
+export declare const APP_VERSION: string;
+export declare const APP_STARTUP_CONTRACT_VERSION = 1;
+export declare const APP_READINESS_PATH = "/health";
+export declare const APP_STARTUP_MODES: readonly ["standalone", "app-managed"];
+export declare const APP_READY_OUTPUTS: readonly ["plain", "json", "silent"];
+export declare const APP_LIFECYCLE_EVENTS: readonly ["app.ready", "app.startup_error", "app.stopping", "app.stopped"];
+export declare const APP_SHUTDOWN_SIGNALS: readonly ["SIGINT", "SIGTERM"];
+export declare const APP_SHUTDOWN_REASONS: readonly ["sigint", "sigterm", "stdin_closed"];
+export type AppStartupMode = typeof APP_STARTUP_MODES[number];
+export type AppReadyOutput = typeof APP_READY_OUTPUTS[number];
+export type AppLifecycleEventName = typeof APP_LIFECYCLE_EVENTS[number];
+export type AppShutdownReason = typeof APP_SHUTDOWN_REASONS[number];
+export type AppReadySignal = 'http';
+export type AppLifecyclePhase = 'starting' | 'ready' | 'stopping' | 'stopped';
+export interface AppCliOptions {
+    help?: boolean;
+    startupMode?: AppStartupMode;
+    managedBy?: string;
+    readyOutput?: AppReadyOutput;
+}
+export interface AppListeningAddress {
+    host: string;
+    port: number;
+    healthUrl: string;
+}
+export interface AppStartupState {
+    contractVersion: number;
+    mode: AppStartupMode;
+    managedBy?: string;
+    readyOutput: AppReadyOutput;
+    readySignal: AppReadySignal;
+    readinessPath: string;
+    phase: AppLifecyclePhase;
+    pid: number;
+    startedAt: string;
+    ready: boolean;
+    address?: AppListeningAddress;
+    shutdownReason?: AppShutdownReason;
+    lastEvent?: AppLifecycleEventName;
+    version: string;
+}
+export interface AppReadinessSnapshot {
+    endpoint: string;
+    authoritative: true;
+    readySignal: AppReadySignal;
+    phase: AppLifecyclePhase;
+    ready: boolean;
+}
+export interface AppOperationalStatus {
+    status: 'ok' | 'degraded' | 'unavailable';
+    summary: string;
+}
+export declare function parseAppCliOptions(argv: string[]): AppCliOptions;
+export declare function createAppStartupState(init?: Partial<AppStartupState>): AppStartupState;
+export declare function resolveAppStartupState(options: AppCliOptions, env: NodeJS.ProcessEnv): AppStartupState;
+export declare function getAppReadinessSnapshot(startup: AppStartupState): AppReadinessSnapshot;
+export declare function getAppLifecycleContract(startup: Pick<AppStartupState, 'contractVersion' | 'readinessPath'>): {
+    startup: number;
+    supportedModes: ("standalone" | "app-managed")[];
+    readinessPath: string;
+    lifecycleEvents: ("app.ready" | "app.startup_error" | "app.stopping" | "app.stopped")[];
+    shutdownSignals: ("SIGINT" | "SIGTERM")[];
+    shutdownReasons: ("sigint" | "sigterm" | "stdin_closed")[];
+};
+export declare function isAppManagedStdinShutdownEnabled(startup: Pick<AppStartupState, 'mode'>): boolean;
+export declare function getAppShutdownContract(startup: Pick<AppStartupState, 'mode'>): {
+    signals: ("SIGINT" | "SIGTERM")[];
+    reasons: ("sigint" | "sigterm" | "stdin_closed")[];
+    stdinCloseEnabled: boolean;
+};
+export declare function getAppOperationalStatus(startup: AppStartupState): AppOperationalStatus;
+export declare function markAppReady(startup: AppStartupState, address: AppListeningAddress): AppStartupState;
+export declare function markAppStopping(startup: AppStartupState, reason?: AppShutdownReason): AppStartupState;
+export declare function markAppStopped(startup: AppStartupState, reason?: AppShutdownReason): AppStartupState;
+export declare function formatAppLifecycleEvent(startup: AppStartupState, event: AppLifecycleEventName, details?: {
+    address?: AppListeningAddress;
+    error?: string;
+    reason?: AppShutdownReason;
+}): string | null;
+export declare function formatAppReadyMessage(startup: AppStartupState, address: AppListeningAddress): string | null;
+export declare function formatAppStoppingMessage(startup: AppStartupState, reason: AppShutdownReason): string | null;
+export declare function formatAppStoppedMessage(startup: AppStartupState, reason: AppShutdownReason): string | null;
+export declare function formatAppStartupError(startup: AppStartupState, error: unknown): string;
+export declare function getAppHelpText(): string;
+//# sourceMappingURL=startup.d.ts.map

package/build/server/app/server/startup.d.ts.map

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

package/build/server/app/server/startup.js

@@ -0,0 +1,311 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const APP_PACKAGE_JSON_CANDIDATE_PATHS = [
+    ['..', '..', 'package.json'],
+    ['..', '..', '..', 'package.json'],
+    ['..', '..', '..', '..', 'package.json'],
+];
+export function resolveAppPackageJsonPath(moduleUrl = import.meta.url) {
+    const moduleDir = dirname(fileURLToPath(moduleUrl));
+    for (const segments of APP_PACKAGE_JSON_CANDIDATE_PATHS) {
+        const candidatePath = join(moduleDir, ...segments);
+        if (existsSync(candidatePath)) {
+            return candidatePath;
+        }
+    }
+    throw new Error(`Could not locate cats-platform package.json from ${moduleDir}. `
+        + `Checked: ${APP_PACKAGE_JSON_CANDIDATE_PATHS.map((segments) => join(moduleDir, ...segments)).join(', ')}`);
+}
+function readAppPackageVersion(moduleUrl = import.meta.url) {
+    const packageJsonPath = resolveAppPackageJsonPath(moduleUrl);
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+    if (!packageJson.version) {
+        throw new Error(`Could not resolve version from ${packageJsonPath}`);
+    }
+    return packageJson.version;
+}
+export const APP_SERVICE_NAME = 'cats-platform';
+export const APP_VERSION = readAppPackageVersion();
+export const APP_STARTUP_CONTRACT_VERSION = 1;
+export const APP_READINESS_PATH = '/health';
+export const APP_STARTUP_MODES = [
+    'standalone',
+    'app-managed',
+];
+export const APP_READY_OUTPUTS = [
+    'plain',
+    'json',
+    'silent',
+];
+export const APP_LIFECYCLE_EVENTS = [
+    'app.ready',
+    'app.startup_error',
+    'app.stopping',
+    'app.stopped',
+];
+export const APP_SHUTDOWN_SIGNALS = [
+    'SIGINT',
+    'SIGTERM',
+];
+export const APP_SHUTDOWN_REASONS = [
+    'sigint',
+    'sigterm',
+    'stdin_closed',
+];
+function isStartupMode(value) {
+    return APP_STARTUP_MODES.includes(value);
+}
+function isReadyOutput(value) {
+    return APP_READY_OUTPUTS.includes(value);
+}
+function readOptionValue(argv, index, flag) {
+    const value = argv[index + 1];
+    if (!value || value.startsWith('--')) {
+        throw new Error(`Missing value for ${flag}`);
+    }
+    return value;
+}
+export function parseAppCliOptions(argv) {
+    const options = {};
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (arg === '--help' || arg === '-h') {
+            options.help = true;
+            continue;
+        }
+        if (arg === '--startup-mode') {
+            const value = readOptionValue(argv, index, arg);
+            if (!isStartupMode(value)) {
+                throw new Error(`Invalid --startup-mode value '${value}'`);
+            }
+            options.startupMode = value;
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith('--startup-mode=')) {
+            const value = arg.slice('--startup-mode='.length);
+            if (!isStartupMode(value)) {
+                throw new Error(`Invalid --startup-mode value '${value}'`);
+            }
+            options.startupMode = value;
+            continue;
+        }
+        if (arg === '--managed-by') {
+            options.managedBy = readOptionValue(argv, index, arg);
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith('--managed-by=')) {
+            options.managedBy = arg.slice('--managed-by='.length);
+            continue;
+        }
+        if (arg === '--ready-output') {
+            const value = readOptionValue(argv, index, arg);
+            if (!isReadyOutput(value)) {
+                throw new Error(`Invalid --ready-output value '${value}'`);
+            }
+            options.readyOutput = value;
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith('--ready-output=')) {
+            const value = arg.slice('--ready-output='.length);
+            if (!isReadyOutput(value)) {
+                throw new Error(`Invalid --ready-output value '${value}'`);
+            }
+            options.readyOutput = value;
+            continue;
+        }
+        throw new Error(`Unknown argument '${arg}'`);
+    }
+    return options;
+}
+export function createAppStartupState(init = {}) {
+    return {
+        contractVersion: init.contractVersion ?? APP_STARTUP_CONTRACT_VERSION,
+        mode: init.mode ?? 'standalone',
+        managedBy: init.managedBy,
+        readyOutput: init.readyOutput ?? 'plain',
+        readySignal: init.readySignal ?? 'http',
+        readinessPath: init.readinessPath ?? APP_READINESS_PATH,
+        phase: init.phase ?? (init.ready ? 'ready' : 'starting'),
+        pid: init.pid ?? process.pid,
+        startedAt: init.startedAt ?? new Date().toISOString(),
+        ready: init.ready ?? false,
+        address: init.address,
+        shutdownReason: init.shutdownReason,
+        lastEvent: init.lastEvent,
+        version: init.version ?? APP_VERSION,
+    };
+}
+export function resolveAppStartupState(options, env) {
+    const modeFromEnv = env.CATS_STARTUP_MODE;
+    const readyOutputFromEnv = env.CATS_READY_OUTPUT;
+    const managedByFromEnv = env.CATS_MANAGED_BY;
+    const normalizedModeFromEnv = isStartupMode(modeFromEnv ?? '')
+        ? modeFromEnv
+        : undefined;
+    const normalizedReadyOutputFromEnv = isReadyOutput(readyOutputFromEnv ?? '')
+        ? readyOutputFromEnv
+        : undefined;
+    const mode = options.startupMode ?? normalizedModeFromEnv ?? 'standalone';
+    const readyOutput = options.readyOutput
+        ?? normalizedReadyOutputFromEnv
+        ?? (mode === 'app-managed' ? 'json' : 'plain');
+    return createAppStartupState({
+        mode,
+        managedBy: options.managedBy ?? managedByFromEnv,
+        readyOutput,
+    });
+}
+export function getAppReadinessSnapshot(startup) {
+    return {
+        endpoint: startup.readinessPath,
+        authoritative: true,
+        readySignal: startup.readySignal,
+        phase: startup.phase,
+        ready: startup.ready && startup.phase === 'ready',
+    };
+}
+export function getAppLifecycleContract(startup) {
+    return {
+        startup: startup.contractVersion,
+        supportedModes: [...APP_STARTUP_MODES],
+        readinessPath: startup.readinessPath,
+        lifecycleEvents: [...APP_LIFECYCLE_EVENTS],
+        shutdownSignals: [...APP_SHUTDOWN_SIGNALS],
+        shutdownReasons: [...APP_SHUTDOWN_REASONS],
+    };
+}
+export function isAppManagedStdinShutdownEnabled(startup) {
+    return startup.mode === 'app-managed';
+}
+export function getAppShutdownContract(startup) {
+    return {
+        signals: [...APP_SHUTDOWN_SIGNALS],
+        reasons: [...APP_SHUTDOWN_REASONS],
+        stdinCloseEnabled: isAppManagedStdinShutdownEnabled(startup),
+    };
+}
+export function getAppOperationalStatus(startup) {
+    switch (startup.phase) {
+        case 'ready':
+            return {
+                status: 'ok',
+                summary: 'Cats app server is ready to accept requests.',
+            };
+        case 'starting':
+            return {
+                status: 'degraded',
+                summary: 'Cats app server is starting and is not ready yet.',
+            };
+        case 'stopping':
+            return {
+                status: 'degraded',
+                summary: `Cats app server is stopping${startup.shutdownReason ? ` (${startup.shutdownReason})` : ''}.`,
+            };
+        case 'stopped':
+        default:
+            return {
+                status: 'unavailable',
+                summary: `Cats app server is stopped${startup.shutdownReason ? ` (${startup.shutdownReason})` : ''}.`,
+            };
+    }
+}
+export function markAppReady(startup, address) {
+    startup.phase = 'ready';
+    startup.ready = true;
+    startup.address = address;
+    return startup;
+}
+export function markAppStopping(startup, reason) {
+    startup.phase = 'stopping';
+    startup.ready = false;
+    if (reason) {
+        startup.shutdownReason = reason;
+    }
+    return startup;
+}
+export function markAppStopped(startup, reason) {
+    startup.phase = 'stopped';
+    startup.ready = false;
+    if (reason) {
+        startup.shutdownReason = reason;
+    }
+    return startup;
+}
+function buildLifecycleEventPayload(startup, event, details = {}) {
+    startup.lastEvent = event;
+    const address = details.address ?? startup.address;
+    const readiness = getAppReadinessSnapshot(startup);
+    return {
+        event,
+        service: APP_SERVICE_NAME,
+        contractVersion: startup.contractVersion,
+        version: startup.version,
+        pid: startup.pid,
+        mode: startup.mode,
+        managedBy: startup.managedBy,
+        startedAt: startup.startedAt,
+        timestamp: new Date().toISOString(),
+        phase: startup.phase,
+        readySignal: startup.readySignal,
+        readinessPath: startup.readinessPath,
+        ready: readiness.ready,
+        host: address?.host,
+        port: address?.port,
+        healthUrl: address?.healthUrl,
+        reason: details.reason ?? startup.shutdownReason,
+        error: details.error,
+    };
+}
+export function formatAppLifecycleEvent(startup, event, details = {}) {
+    if (startup.readyOutput === 'silent' && event !== 'app.startup_error') {
+        startup.lastEvent = event;
+        return null;
+    }
+    const payload = buildLifecycleEventPayload(startup, event, details);
+    if (startup.readyOutput === 'json') {
+        return `${JSON.stringify(payload)}\n`;
+    }
+    switch (event) {
+        case 'app.ready':
+            return `cats listening on http://${payload.host}:${payload.port}\n`;
+        case 'app.stopping':
+            return `cats stopping (${payload.reason || 'shutdown'})\n`;
+        case 'app.stopped':
+            return `cats stopped (${payload.reason || 'shutdown'})\n`;
+        case 'app.startup_error':
+            return `${payload.error || 'Unknown startup error'}\n`;
+        default:
+            return null;
+    }
+}
+export function formatAppReadyMessage(startup, address) {
+    return formatAppLifecycleEvent(startup, 'app.ready', { address });
+}
+export function formatAppStoppingMessage(startup, reason) {
+    return formatAppLifecycleEvent(startup, 'app.stopping', { reason });
+}
+export function formatAppStoppedMessage(startup, reason) {
+    return formatAppLifecycleEvent(startup, 'app.stopped', { reason });
+}
+export function formatAppStartupError(startup, error) {
+    const message = error instanceof Error ? error.stack ?? error.message : String(error);
+    return formatAppLifecycleEvent(startup, 'app.startup_error', {
+        error: message,
+    }) || `${message}\n`;
+}
+export function getAppHelpText() {
+    return [
+        'Usage: cats-platform [options]',
+        '',
+        'Options:',
+        '  --startup-mode <standalone|app-managed>',
+        '  --managed-by <name>',
+        '  --ready-output <plain|json|silent>',
+        '  -h, --help',
+    ].join('\n');
+}
+//# sourceMappingURL=startup.js.map

package/build/server/app/server/startup.js.map

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

package/build/server/app/server/startupRecovery.d.ts

@@ -0,0 +1,5 @@
+import type { ResolvedServerDependencies } from './contracts.js';
+export declare function runStartupRecoveryPasses(passes: Array<() => Promise<unknown>>): Promise<void>;
+export declare function runServerStartupRecoveryPasses(dependencies: ResolvedServerDependencies): Promise<void>;
+export declare function reconcileAuthRepairOnStartup(dependencies: Pick<ResolvedServerDependencies, 'shared'>): Promise<void>;
+//# sourceMappingURL=startupRecovery.d.ts.map

package/build/server/app/server/startupRecovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startupRecovery.d.ts","sourceRoot":"","sources":["../../../../src/app/server/startupRecovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AASjE,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,wBAAsB,8BAA8B,CAClD,YAAY,EAAE,0BAA0B,GACvC,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,wBAAsB,4BAA4B,CAChD,YAAY,EAAE,IAAI,CAAC,0BAA0B,EAAE,QAAQ,CAAC,GACvD,OAAO,CAAC,IAAI,CAAC,CAkBf"}

package/build/server/app/server/startupRecovery.js

@@ -0,0 +1,43 @@
+import { reconcileChatWorkflowRecoveryOnStartup } from './chatWorkflowRecovery.js';
+import { reconcileOrchestratorRecoveryOnStartup } from './orchestratorRecovery.js';
+import { reconcilePollingOnStartup } from './polling.js';
+import { resolvePlatformAuthReadiness, startPlatformAuthRepairMode, } from '../../platform/auth/index.js';
+export async function runStartupRecoveryPasses(passes) {
+    for (const pass of passes) {
+        try {
+            await pass();
+        }
+        catch {
+            // Startup recovery is best-effort. Do not block later passes.
+        }
+    }
+}
+export async function runServerStartupRecoveryPasses(dependencies) {
+    await runStartupRecoveryPasses([
+        () => reconcileAuthRepairOnStartup(dependencies),
+        () => reconcilePollingOnStartup(dependencies),
+        () => dependencies.chat.telegramCommandSurfaceSync.reconcile(),
+        () => reconcileChatWorkflowRecoveryOnStartup(dependencies),
+        () => reconcileOrchestratorRecoveryOnStartup(dependencies),
+    ]);
+}
+export async function reconcileAuthRepairOnStartup(dependencies) {
+    const core = await dependencies.shared.coreStore.readCore();
+    const authStateStatus = await dependencies.shared.authStore.readStateStatus();
+    const readiness = resolvePlatformAuthReadiness({
+        setupCompleteAt: core.setupCompleteAt,
+        authStateStatus,
+    });
+    const repair = await startPlatformAuthRepairMode({
+        readiness,
+        sessionSecret: dependencies.shared.config.auth.sessionSecret,
+        recoveryTokenPath: dependencies.shared.config.auth.recoveryTokenPath,
+        now: dependencies.shared.now?.() ?? new Date(),
+    });
+    if (!repair) {
+        return;
+    }
+    await dependencies.shared.setAuthRecoveryTokenState?.(repair.tokenState);
+    process.stderr.write(`[cats-platform-auth] ${JSON.stringify(repair.structuredLog)}\n`);
+}
+//# sourceMappingURL=startupRecovery.js.map

package/build/server/app/server/startupRecovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startupRecovery.js","sourceRoot":"","sources":["../../../../src/app/server/startupRecovery.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sCAAsC,EAAE,MAAM,2BAA2B,CAAC;AACnF,OAAO,EAAE,sCAAsC,EAAE,MAAM,2BAA2B,CAAC;AACnF,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,8BAA8B,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAqC;IAErC,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,MAAM,IAAI,EAAE,CAAC;QACf,CAAC;QAAC,MAAM,CAAC;YACP,8DAA8D;QAChE,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,YAAwC;IAExC,MAAM,wBAAwB,CAAC;QAC7B,GAAG,EAAE,CAAC,4BAA4B,CAAC,YAAY,CAAC;QAChD,GAAG,EAAE,CAAC,yBAAyB,CAAC,YAAY,CAAC;QAC7C,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,0BAA0B,CAAC,SAAS,EAAE;QAC9D,GAAG,EAAE,CAAC,sCAAsC,CAAC,YAAY,CAAC;QAC1D,GAAG,EAAE,CAAC,sCAAsC,CAAC,YAAY,CAAC;KAC3D,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,YAAwD;IAExD,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;IAC5D,MAAM,eAAe,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC;IAC9E,MAAM,SAAS,GAAG,4BAA4B,CAAC;QAC7C,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,eAAe;KAChB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,2BAA2B,CAAC;QAC/C,SAAS;QACT,aAAa,EAAE,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa;QAC5D,iBAAiB,EAAE,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB;QACpE,GAAG,EAAE,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,IAAI,IAAI,IAAI,EAAE;KAC/C,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;IACT,CAAC;IACD,MAAM,YAAY,CAAC,MAAM,CAAC,yBAAyB,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACzE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;AACzF,CAAC"}

package/build/server/app/server/startupTrace.d.ts

@@ -0,0 +1,15 @@
+export interface AppStartupTrace {
+    enabled: boolean;
+    trace(phase: string, details?: Record<string, unknown>): void;
+}
+interface AppStartupTraceOptions {
+    env?: Readonly<NodeJS.ProcessEnv>;
+    now?: () => Date;
+    write?: (line: string) => void;
+    startedAtMs?: number;
+    pid?: number;
+}
+export declare function isAppStartupTraceEnabled(env?: Readonly<NodeJS.ProcessEnv>): boolean;
+export declare function createAppStartupTrace(options?: AppStartupTraceOptions): AppStartupTrace;
+export {};
+//# sourceMappingURL=startupTrace.d.ts.map

package/build/server/app/server/startupTrace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startupTrace.d.ts","sourceRoot":"","sources":["../../../../src/app/server/startupTrace.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC/D;AAED,UAAU,sBAAsB;IAC9B,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAkBD,wBAAgB,wBAAwB,CACtC,GAAG,GAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAe,GAC7C,OAAO,CAET;AAED,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,sBAA2B,GACnC,eAAe,CA6BjB"}

package/build/server/app/server/startupTrace.js

@@ -0,0 +1,46 @@
+function parseBooleanEnv(value) {
+    if (!value) {
+        return false;
+    }
+    switch (value.trim().toLowerCase()) {
+        case '1':
+        case 'true':
+        case 'yes':
+        case 'on':
+            return true;
+        default:
+            return false;
+    }
+}
+export function isAppStartupTraceEnabled(env = process.env) {
+    return parseBooleanEnv(env.CATS_PLATFORM_STARTUP_TRACE);
+}
+export function createAppStartupTrace(options = {}) {
+    const env = options.env ?? process.env;
+    const enabled = isAppStartupTraceEnabled(env);
+    const now = options.now ?? (() => new Date());
+    const write = options.write ?? ((line) => {
+        process.stderr.write(line);
+    });
+    const startedAtMs = options.startedAtMs ?? Date.now();
+    const pid = options.pid ?? process.pid;
+    return {
+        enabled,
+        trace(phase, details = {}) {
+            if (!enabled) {
+                return;
+            }
+            const timestamp = now();
+            write(`${JSON.stringify({
+                event: 'app.startup_trace',
+                service: 'cats-platform',
+                pid,
+                phase,
+                timestamp: timestamp.toISOString(),
+                elapsedMs: Math.max(0, timestamp.getTime() - startedAtMs),
+                details,
+            })}\n`);
+        },
+    };
+}
+//# sourceMappingURL=startupTrace.js.map

package/build/server/app/server/startupTrace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startupTrace.js","sourceRoot":"","sources":["../../../../src/app/server/startupTrace.ts"],"names":[],"mappings":"AAaA,SAAS,eAAe,CAAC,KAAyB;IAChD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,KAAK,CAAC;IACf,CAAC;IAED,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QACnC,KAAK,GAAG,CAAC;QACT,KAAK,MAAM,CAAC;QACZ,KAAK,KAAK,CAAC;QACX,KAAK,IAAI;YACP,OAAO,IAAI,CAAC;QACd;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,MAAmC,OAAO,CAAC,GAAG;IAE9C,OAAO,eAAe,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,UAAkC,EAAE;IAEpC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,OAAO,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE;QAC/C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;IACtD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IAEvC,OAAO;QACL,OAAO;QACP,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,EAAE;YACvB,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO;YACT,CAAC;YAED,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC;YACxB,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;gBACtB,KAAK,EAAE,mBAAmB;gBAC1B,OAAO,EAAE,eAAe;gBACxB,GAAG;gBACH,KAAK;gBACL,SAAS,EAAE,SAAS,CAAC,WAAW,EAAE;gBAClC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,OAAO,EAAE,GAAG,WAAW,CAAC;gBACzD,OAAO;aACR,CAAC,IAAI,CAAC,CAAC;QACV,CAAC;KACF,CAAC;AACJ,CAAC"}

package/build/server/app/server/subscribeRoutes.d.ts

@@ -0,0 +1,16 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { CoreStore } from '../../core/store.js';
+import type { ChatApiDependencies } from '../../products/chat/api/routeSupport.js';
+export interface EntitySubscriptionRouteContext {
+    request: IncomingMessage;
+    response: ServerResponse;
+    url: URL;
+    method: string;
+    dependencies: ChatApiDependencies & {
+        coreStore: CoreStore;
+    };
+    artifactRefreshMs?: number;
+}
+export declare const ARTIFACT_ENTITY_SUBSCRIPTION_REFRESH_MS = 500;
+export declare function routeEntitySubscriptionApi(context: EntitySubscriptionRouteContext): Promise<boolean>;
+//# sourceMappingURL=subscribeRoutes.d.ts.map

package/build/server/app/server/subscribeRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribeRoutes.d.ts","sourceRoot":"","sources":["../../../../src/app/server/subscribeRoutes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAsBnF,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,eAAe,CAAC;IACzB,QAAQ,EAAE,cAAc,CAAC;IACzB,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,mBAAmB,GAAG;QAClC,SAAS,EAAE,SAAS,CAAC;KACtB,CAAC;IACF,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,uCAAuC,MAAM,CAAC;AAmO3D,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,OAAO,CAAC,CA6BlB"}