@agent-vm/agent-vm 0.0.96 → 0.0.98

package/dist/gateway/gateway-zone-support.js.map

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

package/dist/observability/observability-compose.d.ts

@@ -0,0 +1,24 @@
+import type { ManagedObservabilityRuntimeConfig } from './observability-config.js';
+export interface ObservabilityComposeService {
+    readonly image: string;
+    readonly command?: readonly string[];
+    readonly environment?: readonly string[];
+    readonly ports: readonly ObservabilityComposePort[];
+    readonly restart: 'unless-stopped';
+    readonly user?: string;
+    readonly volumes: readonly string[];
+    readonly depends_on?: readonly string[];
+}
+export interface ObservabilityComposePort {
+    readonly hostIp: string;
+    readonly protocol: 'tcp';
+    readonly published: number;
+    readonly target: number;
+}
+export interface ObservabilityComposeModel {
+    readonly name: string;
+    readonly services: Record<string, ObservabilityComposeService>;
+}
+export declare function createObservabilityComposeModel(config: ManagedObservabilityRuntimeConfig): ObservabilityComposeModel;
+export declare function renderObservabilityComposeYaml(model: ObservabilityComposeModel): string;
+//# sourceMappingURL=observability-compose.d.ts.map

package/dist/observability/observability-compose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-compose.d.ts","sourceRoot":"","sources":["../../src/observability/observability-compose.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAIX,iCAAiC,EACjC,MAAM,2BAA2B,CAAC;AAOnC,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACpD,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;CAC/D;AA0DD,wBAAgB,+BAA+B,CAC9C,MAAM,EAAE,iCAAiC,GACvC,yBAAyB,CA6D3B;AAkBD,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM,CAqBvF"}

package/dist/observability/observability-compose.js

@@ -0,0 +1,144 @@
+import path from 'node:path';
+const VICTORIA_METRICS_IMAGE = 'victoriametrics/victoria-metrics:v1.144.0';
+const VICTORIA_LOGS_IMAGE = 'victoriametrics/victoria-logs:v1.50.0';
+const VICTORIA_TRACES_IMAGE = 'victoriametrics/victoria-traces:v0.9.2';
+const OTEL_COLLECTOR_IMAGE = 'otel/opentelemetry-collector-contrib:0.116.1';
+function createLoopbackPort(bindAddress, hostPort, containerPort) {
+    return {
+        hostIp: bindAddress,
+        protocol: 'tcp',
+        published: hostPort,
+        target: containerPort,
+    };
+}
+function renderBaseRetentionFlags(retention) {
+    return [
+        `-retentionPeriod=${retention.period}`,
+        ...(retention.minFreeDiskSpaceBytes === undefined
+            ? []
+            : [`-storage.minFreeDiskSpaceBytes=${retention.minFreeDiskSpaceBytes}`]),
+    ];
+}
+function renderByteBoundedRetentionFlags(retention) {
+    return [
+        ...renderBaseRetentionFlags(retention),
+        ...(retention.maxDiskSpaceUsageBytes === undefined
+            ? []
+            : [`-retention.maxDiskSpaceUsageBytes=${retention.maxDiskSpaceUsageBytes}`]),
+    ];
+}
+function renderDiskBoundedRetentionFlags(retention) {
+    return [
+        ...renderBaseRetentionFlags(retention),
+        ...(retention.maxDiskSpaceUsageBytes === undefined
+            ? []
+            : [`-retention.maxDiskSpaceUsageBytes=${retention.maxDiskSpaceUsageBytes}`]),
+        ...(retention.maxDiskUsagePercent === undefined
+            ? []
+            : [`-retention.maxDiskUsagePercent=${String(retention.maxDiskUsagePercent)}`]),
+    ];
+}
+function resolveHostUserSpec() {
+    const getuid = process.getuid;
+    const getgid = process.getgid;
+    if (typeof getuid !== 'function' || typeof getgid !== 'function') {
+        return undefined;
+    }
+    return `${String(getuid())}:${String(getgid())}`;
+}
+export function createObservabilityComposeModel(config) {
+    const hostUserSpec = resolveHostUserSpec();
+    return {
+        name: config.projectName,
+        services: {
+            'victoria-metrics': {
+                image: VICTORIA_METRICS_IMAGE,
+                command: [
+                    '-storageDataPath=/victoria-metrics-data',
+                    ...renderBaseRetentionFlags(config.retention.metrics),
+                ],
+                ports: [createLoopbackPort(config.bindAddress, config.ports.metrics, 8428)],
+                restart: 'unless-stopped',
+                ...(hostUserSpec === undefined ? {} : { user: hostUserSpec }),
+                volumes: [path.join(config.dataDir, 'metrics') + ':/victoria-metrics-data'],
+            },
+            'victoria-logs': {
+                image: VICTORIA_LOGS_IMAGE,
+                command: [
+                    '-storageDataPath=/victoria-logs-data',
+                    ...renderByteBoundedRetentionFlags(config.retention.logs),
+                ],
+                ports: [createLoopbackPort(config.bindAddress, config.ports.logs, 9428)],
+                restart: 'unless-stopped',
+                ...(hostUserSpec === undefined ? {} : { user: hostUserSpec }),
+                volumes: [path.join(config.dataDir, 'logs') + ':/victoria-logs-data'],
+            },
+            'victoria-traces': {
+                image: VICTORIA_TRACES_IMAGE,
+                command: [
+                    '-storageDataPath=/victoria-traces-data',
+                    ...renderDiskBoundedRetentionFlags(config.retention.traces),
+                ],
+                ports: [createLoopbackPort(config.bindAddress, config.ports.traces, 10_428)],
+                restart: 'unless-stopped',
+                ...(hostUserSpec === undefined ? {} : { user: hostUserSpec }),
+                volumes: [path.join(config.dataDir, 'traces') + ':/victoria-traces-data'],
+            },
+            'otel-collector': {
+                image: OTEL_COLLECTOR_IMAGE,
+                command: ['--config=/etc/otelcol/config.yaml'],
+                depends_on: ['victoria-metrics', 'victoria-logs', 'victoria-traces'],
+                environment: [
+                    'HTTP_PROXY=',
+                    'HTTPS_PROXY=',
+                    'NO_PROXY=victoria-metrics,victoria-logs,victoria-traces,localhost,127.0.0.1,::1',
+                ],
+                ports: [
+                    createLoopbackPort(config.bindAddress, config.ports.collectorGrpc, 4317),
+                    createLoopbackPort(config.bindAddress, config.ports.collectorHttp, 4318),
+                    createLoopbackPort(config.bindAddress, config.ports.collectorHealth, 13_133),
+                ],
+                restart: 'unless-stopped',
+                ...(hostUserSpec === undefined ? {} : { user: hostUserSpec }),
+                volumes: [
+                    path.join(config.runtimeDir, 'otel-collector-config.yaml') +
+                        ':/etc/otelcol/config.yaml:ro',
+                ],
+            },
+        },
+    };
+}
+function renderYamlArray(indent, values) {
+    return values.map((value) => `${indent}- ${JSON.stringify(value)}`);
+}
+function renderYamlPorts(indent, ports) {
+    return ports.flatMap((port) => [
+        `${indent}- host_ip: ${JSON.stringify(port.hostIp)}`,
+        `${indent}  published: ${JSON.stringify(String(port.published))}`,
+        `${indent}  target: ${String(port.target)}`,
+        `${indent}  protocol: ${port.protocol}`,
+    ]);
+}
+export function renderObservabilityComposeYaml(model) {
+    const lines = [`name: ${JSON.stringify(model.name)}`, 'services:'];
+    for (const [serviceName, service] of Object.entries(model.services)) {
+        lines.push(`  ${serviceName}:`, `    image: ${service.image}`);
+        if (service.command !== undefined) {
+            lines.push('    command:', ...renderYamlArray('      ', service.command));
+        }
+        if (service.depends_on !== undefined) {
+            lines.push('    depends_on:', ...renderYamlArray('      ', service.depends_on));
+        }
+        if (service.environment !== undefined) {
+            lines.push('    environment:', ...renderYamlArray('      ', service.environment));
+        }
+        lines.push(`    restart: ${service.restart}`);
+        if (service.user !== undefined) {
+            lines.push(`    user: ${JSON.stringify(service.user)}`);
+        }
+        lines.push('    ports:', ...renderYamlPorts('      ', service.ports));
+        lines.push('    volumes:', ...renderYamlArray('      ', service.volumes));
+    }
+    return `${lines.join('\n')}\n`;
+}
+//# sourceMappingURL=observability-compose.js.map

package/dist/observability/observability-compose.js.map

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

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

@@ -0,0 +1,62 @@
+import type { LoadedSystemConfig } from '../config/system-config.js';
+export interface ObservabilityBaseRetentionPolicy {
+    readonly period: string;
+    readonly minFreeDiskSpaceBytes?: string | undefined;
+}
+export interface ObservabilityByteBoundedRetentionPolicy extends ObservabilityBaseRetentionPolicy {
+    readonly maxDiskSpaceUsageBytes?: string | undefined;
+}
+export interface ObservabilityDiskBoundedRetentionPolicy extends ObservabilityBaseRetentionPolicy {
+    readonly maxDiskSpaceUsageBytes?: string | undefined;
+    readonly maxDiskUsagePercent?: number | undefined;
+}
+export interface ObservabilityPortConfig {
+    readonly collectorGrpc: number;
+    readonly collectorHttp: number;
+    readonly collectorHealth: number;
+    readonly metrics: number;
+    readonly logs: number;
+    readonly traces: number;
+}
+export interface ObservabilityZoneRuntimeConfig {
+    readonly zoneId: string;
+    readonly serviceName: string;
+    readonly traces: boolean;
+    readonly metrics: boolean;
+    readonly logs: boolean;
+    readonly sampleRate: number;
+    readonly flushIntervalMs: number;
+    readonly diagnosticsFlags: readonly string[];
+}
+interface ObservabilityEnabledRuntimeConfigBase {
+    readonly enabled: true;
+    readonly stackMode: 'external' | 'managed';
+    readonly runtimeDir: string;
+    readonly bindAddress: '127.0.0.1' | '::1';
+    readonly ports: ObservabilityPortConfig;
+    readonly prepareOnBuild: boolean;
+    readonly waitOnBuild: boolean;
+    readonly controllerStartPolicy: 'degraded' | 'require-ready' | 'off';
+    readonly startupCheckTimeoutMs: number;
+    readonly zones: readonly ObservabilityZoneRuntimeConfig[];
+}
+export interface ManagedObservabilityRuntimeConfig extends ObservabilityEnabledRuntimeConfigBase {
+    readonly stackMode: 'managed';
+    readonly projectName: string;
+    readonly dataDir: string;
+    readonly retention: {
+        readonly metrics: ObservabilityBaseRetentionPolicy;
+        readonly logs: ObservabilityByteBoundedRetentionPolicy;
+        readonly traces: ObservabilityDiskBoundedRetentionPolicy;
+    };
+}
+export interface ExternalObservabilityRuntimeConfig extends ObservabilityEnabledRuntimeConfigBase {
+    readonly stackMode: 'external';
+}
+export type EnabledObservabilityRuntimeConfig = ExternalObservabilityRuntimeConfig | ManagedObservabilityRuntimeConfig;
+export type ObservabilityRuntimeConfig = {
+    readonly enabled: false;
+} | EnabledObservabilityRuntimeConfig;
+export declare function createObservabilityRuntimeConfig(config: LoadedSystemConfig): ObservabilityRuntimeConfig;
+export {};
+//# sourceMappingURL=observability-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"observability-config.d.ts","sourceRoot":"","sources":["../../src/observability/observability-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,MAAM,WAAW,gCAAgC;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpD;AAED,MAAM,WAAW,uCAAwC,SAAQ,gCAAgC;IAChG,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrD;AAED,MAAM,WAAW,uCAAwC,SAAQ,gCAAgC;IAChG,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClD;AAED,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,8BAA8B;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED,UAAU,qCAAqC;IAC9C,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,UAAU,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,WAAW,GAAG,KAAK,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,qBAAqB,EAAE,UAAU,GAAG,eAAe,GAAG,KAAK,CAAC;IACrE,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,SAAS,8BAA8B,EAAE,CAAC;CAC1D;AAED,MAAM,WAAW,iCAAkC,SAAQ,qCAAqC;IAC/F,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE;QACnB,QAAQ,CAAC,OAAO,EAAE,gCAAgC,CAAC;QACnD,QAAQ,CAAC,IAAI,EAAE,uCAAuC,CAAC;QACvD,QAAQ,CAAC,MAAM,EAAE,uCAAuC,CAAC;KACzD,CAAC;CACF;AAED,MAAM,WAAW,kCAAmC,SAAQ,qCAAqC;IAChG,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;CAC/B;AAED,MAAM,MAAM,iCAAiC,GAC1C,kCAAkC,GAClC,iCAAiC,CAAC;AAErC,MAAM,MAAM,0BAA0B,GACnC;IACA,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;CACvB,GACD,iCAAiC,CAAC;AAwBrC,wBAAgB,gCAAgC,CAC/C,MAAM,EAAE,kBAAkB,GACxB,0BAA0B,CAwD5B"}

package/dist/observability/observability-config.js

@@ -0,0 +1,60 @@
+import path from 'node:path';
+function isExternalHostObservabilityConfig(observability) {
+    return observability?.enabled === true && observability.stack.mode === 'external';
+}
+function isManagedHostObservabilityConfig(observability) {
+    return observability?.enabled === true && observability.stack.mode === 'managed';
+}
+export function createObservabilityRuntimeConfig(config) {
+    const hostObservability = config.host.observability;
+    if (hostObservability?.enabled !== true) {
+        return { enabled: false };
+    }
+    const zones = config.zones.flatMap((zone) => {
+        if (zone.observability?.enabled !== true) {
+            return [];
+        }
+        const { openclaw } = zone.observability;
+        return [
+            {
+                zoneId: zone.id,
+                serviceName: openclaw.serviceName,
+                traces: openclaw.traces,
+                metrics: openclaw.metrics,
+                logs: openclaw.logs,
+                sampleRate: openclaw.sampleRate,
+                flushIntervalMs: openclaw.flushIntervalMs,
+                diagnosticsFlags: openclaw.diagnosticsFlags,
+            },
+        ];
+    });
+    const baseConfig = {
+        enabled: true,
+        runtimeDir: path.join(config.runtimeDir, 'observability', config.host.projectNamespace),
+        bindAddress: hostObservability.bindAddress,
+        ports: hostObservability.ports,
+        prepareOnBuild: hostObservability.prepareOnBuild,
+        waitOnBuild: hostObservability.waitOnBuild,
+        controllerStartPolicy: hostObservability.controllerStartPolicy,
+        startupCheckTimeoutMs: hostObservability.startupCheckTimeoutMs,
+        zones,
+    };
+    if (isExternalHostObservabilityConfig(hostObservability)) {
+        return {
+            ...baseConfig,
+            stackMode: 'external',
+        };
+    }
+    if (!isManagedHostObservabilityConfig(hostObservability)) {
+        throw new Error('Managed host observability requires dataDir and retention.');
+    }
+    const projectName = hostObservability.projectName ?? `agent-vm-observability-${config.host.projectNamespace}`;
+    return {
+        ...baseConfig,
+        stackMode: 'managed',
+        projectName,
+        dataDir: hostObservability.dataDir,
+        retention: hostObservability.retention,
+    };
+}
+//# sourceMappingURL=observability-config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"observability-config.js","sourceRoot":"","sources":["../../src/observability/observability-config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAsF7B,SAAS,iCAAiC,CACzC,aAAsC;IAEtC,OAAO,aAAa,EAAE,OAAO,KAAK,IAAI,IAAI,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC;AACnF,CAAC;AAED,SAAS,gCAAgC,CACxC,aAAsC;IAEtC,OAAO,aAAa,EAAE,OAAO,KAAK,IAAI,IAAI,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC/C,MAA0B;IAE1B,MAAM,iBAAiB,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;IACpD,IAAI,iBAAiB,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;QACzC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAA6C,EAAE;QACtF,IAAI,IAAI,CAAC,aAAa,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;YAC1C,OAAO,EAAE,CAAC;QACX,CAAC;QACD,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC;QACxC,OAAO;YACN;gBACC,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,eAAe,EAAE,QAAQ,CAAC,eAAe;gBACzC,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;aAC3C;SACD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG;QAClB,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC;QACvF,WAAW,EAAE,iBAAiB,CAAC,WAAW;QAC1C,KAAK,EAAE,iBAAiB,CAAC,KAAK;QAC9B,cAAc,EAAE,iBAAiB,CAAC,cAAc;QAChD,WAAW,EAAE,iBAAiB,CAAC,WAAW;QAC1C,qBAAqB,EAAE,iBAAiB,CAAC,qBAAqB;QAC9D,qBAAqB,EAAE,iBAAiB,CAAC,qBAAqB;QAC9D,KAAK;KAC8D,CAAC;IAErE,IAAI,iCAAiC,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC1D,OAAO;YACN,GAAG,UAAU;YACb,SAAS,EAAE,UAAU;SACrB,CAAC;IACH,CAAC;IAED,IAAI,CAAC,gCAAgC,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAC/E,CAAC;IACD,MAAM,WAAW,GAChB,iBAAiB,CAAC,WAAW,IAAI,0BAA0B,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC3F,OAAO;QACN,GAAG,UAAU;QACb,SAAS,EAAE,SAAS;QACpB,WAAW;QACX,OAAO,EAAE,iBAAiB,CAAC,OAAO;QAClC,SAAS,EAAE,iBAAiB,CAAC,SAAS;KACtC,CAAC;AACH,CAAC"}

package/dist/observability/observability-lifecycle.d.ts

@@ -0,0 +1,27 @@
+import type { LoadedSystemConfig } from '../config/system-config.js';
+import { type ManagedObservabilityRuntimeConfig } from './observability-config.js';
+import { checkObservabilityStackReadiness } from './observability-readiness.js';
+export interface PrepareObservabilityStackOptions {
+    readonly config: ManagedObservabilityRuntimeConfig;
+    readonly checkReadiness?: typeof checkObservabilityStackReadiness;
+    readonly runCompose?: typeof runDockerCompose;
+    readonly wait: boolean;
+}
+export interface PrepareObservabilityStackResult {
+    readonly composePath: string;
+    readonly collectorConfigPath: string;
+    readonly status: 'started' | 'ready';
+}
+export declare function writeObservabilityArtifacts(config: ManagedObservabilityRuntimeConfig): Promise<{
+    readonly composePath: string;
+    readonly collectorConfigPath: string;
+}>;
+declare function runDockerCompose(options: {
+    readonly composePath: string;
+    readonly projectName: string;
+    readonly wait: boolean;
+}): Promise<void>;
+export declare function prepareObservabilityStack(options: PrepareObservabilityStackOptions): Promise<PrepareObservabilityStackResult>;
+export declare function resolveBuildObservabilityConfig(systemConfig: LoadedSystemConfig): ManagedObservabilityRuntimeConfig | undefined;
+export {};
+//# sourceMappingURL=observability-lifecycle.d.ts.map

package/dist/observability/observability-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-lifecycle.d.ts","sourceRoot":"","sources":["../../src/observability/observability-lifecycle.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAKrE,OAAO,EAEN,KAAK,iCAAiC,EACtC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,gCAAgC,EAAE,MAAM,8BAA8B,CAAC;AAMhF,MAAM,WAAW,gCAAgC;IAChD,QAAQ,CAAC,MAAM,EAAE,iCAAiC,CAAC;IACnD,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,gCAAgC,CAAC;IAClE,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,gBAAgB,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,+BAA+B;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;CACrC;AAgBD,wBAAsB,2BAA2B,CAChD,MAAM,EAAE,iCAAiC,GACvC,OAAO,CAAC;IACV,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACrC,CAAC,CAkCD;AAED,iBAAS,gBAAgB,CAAC,OAAO,EAAE;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACvB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBhB;AAED,wBAAsB,yBAAyB,CAC9C,OAAO,EAAE,gCAAgC,GACvC,OAAO,CAAC,+BAA+B,CAAC,CAuB1C;AAED,wBAAgB,+BAA+B,CAC9C,YAAY,EAAE,kBAAkB,GAC9B,iCAAiC,GAAG,SAAS,CAY/C"}

package/dist/observability/observability-lifecycle.js

@@ -0,0 +1,101 @@
+import { spawn } from 'node:child_process';
+import { chmod, mkdir, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { createObservabilityComposeModel, renderObservabilityComposeYaml, } from './observability-compose.js';
+import { createObservabilityRuntimeConfig, } from './observability-config.js';
+import { checkObservabilityStackReadiness } from './observability-readiness.js';
+import { createOtelCollectorConfigModel, renderOtelCollectorConfigYaml, } from './otel-collector-config.js';
+const OBSERVABILITY_DIRECTORY_MODE = 0o700;
+const OBSERVABILITY_FILE_MODE = 0o600;
+function formatUnknownError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function createObservabilityComposeStartupError(error) {
+    return new Error(`Host observability Docker Compose startup failed. Ensure Docker Compose is installed and running, or rerun agent-vm build with --no-observability to skip this build run. Cause: ${formatUnknownError(error)}`, { cause: error });
+}
+export async function writeObservabilityArtifacts(config) {
+    const directoryPaths = [
+        config.runtimeDir,
+        config.dataDir,
+        path.join(config.dataDir, 'metrics'),
+        path.join(config.dataDir, 'logs'),
+        path.join(config.dataDir, 'traces'),
+    ];
+    await Promise.all(directoryPaths.map(async (directoryPath) => {
+        await mkdir(directoryPath, { mode: OBSERVABILITY_DIRECTORY_MODE, recursive: true });
+        await chmod(directoryPath, OBSERVABILITY_DIRECTORY_MODE);
+    }));
+    const composePath = path.join(config.runtimeDir, 'docker-compose.observability.yml');
+    const collectorConfigPath = path.join(config.runtimeDir, 'otel-collector-config.yaml');
+    await Promise.all([
+        writeFile(composePath, renderObservabilityComposeYaml(createObservabilityComposeModel(config)), { encoding: 'utf8', mode: OBSERVABILITY_FILE_MODE }),
+        writeFile(collectorConfigPath, renderOtelCollectorConfigYaml(createOtelCollectorConfigModel(config)), { encoding: 'utf8', mode: OBSERVABILITY_FILE_MODE }),
+    ]);
+    await Promise.all([
+        chmod(composePath, OBSERVABILITY_FILE_MODE),
+        chmod(collectorConfigPath, OBSERVABILITY_FILE_MODE),
+    ]);
+    return { composePath, collectorConfigPath };
+}
+function runDockerCompose(options) {
+    const args = [
+        'compose',
+        '--project-name',
+        options.projectName,
+        '--file',
+        options.composePath,
+        'up',
+        '-d',
+        ...(options.wait ? ['--wait'] : []),
+    ];
+    return new Promise((resolve, reject) => {
+        const childProcess = spawn('docker', args, { stdio: 'inherit' });
+        childProcess.once('error', reject);
+        childProcess.once('exit', (exitCode) => {
+            if (exitCode === 0) {
+                resolve();
+                return;
+            }
+            reject(new Error(`docker ${args.join(' ')} exited with code ${String(exitCode)}.`));
+        });
+    });
+}
+export async function prepareObservabilityStack(options) {
+    const artifacts = await writeObservabilityArtifacts(options.config);
+    try {
+        await (options.runCompose ?? runDockerCompose)({
+            composePath: artifacts.composePath,
+            projectName: options.config.projectName,
+            wait: options.wait,
+        });
+    }
+    catch (error) {
+        throw createObservabilityComposeStartupError(error);
+    }
+    if (options.wait) {
+        const readinessResult = await (options.checkReadiness ?? checkObservabilityStackReadiness)({
+            config: options.config,
+        });
+        if (!readinessResult.ok) {
+            throw new Error(`Host observability stack is not ready: ${readinessResult.reason}`);
+        }
+    }
+    return {
+        ...artifacts,
+        status: options.wait ? 'ready' : 'started',
+    };
+}
+export function resolveBuildObservabilityConfig(systemConfig) {
+    const observabilityConfig = createObservabilityRuntimeConfig(systemConfig);
+    if (!observabilityConfig.enabled) {
+        return undefined;
+    }
+    if (observabilityConfig.stackMode !== 'managed') {
+        return undefined;
+    }
+    if (!observabilityConfig.prepareOnBuild || observabilityConfig.zones.length === 0) {
+        return undefined;
+    }
+    return observabilityConfig;
+}
+//# sourceMappingURL=observability-lifecycle.js.map

package/dist/observability/observability-lifecycle.js.map

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

package/dist/observability/observability-readiness.d.ts

@@ -0,0 +1,17 @@
+import type { EnabledObservabilityRuntimeConfig } from './observability-config.js';
+export type ObservabilityReadinessResult = {
+    readonly ok: true;
+    readonly status: 'ready';
+} | {
+    readonly ok: false;
+    readonly reason: string;
+    readonly status: 'unavailable';
+};
+export interface CheckObservabilityStackReadinessOptions {
+    readonly config: EnabledObservabilityRuntimeConfig;
+    readonly fetchImpl?: typeof fetch;
+    readonly probeTimeoutMs?: number;
+    readonly retryDelayMs?: number;
+}
+export declare function checkObservabilityStackReadiness(options: CheckObservabilityStackReadinessOptions): Promise<ObservabilityReadinessResult>;
+//# sourceMappingURL=observability-readiness.d.ts.map

package/dist/observability/observability-readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-readiness.d.ts","sourceRoot":"","sources":["../../src/observability/observability-readiness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,2BAA2B,CAAC;AAEnF,MAAM,MAAM,4BAA4B,GACrC;IACA,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CACxB,GACD;IACA,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEL,MAAM,WAAW,uCAAuC;IACvD,QAAQ,CAAC,MAAM,EAAE,iCAAiC,CAAC;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAC/B;AA0GD,wBAAsB,gCAAgC,CACrD,OAAO,EAAE,uCAAuC,GAC9C,OAAO,CAAC,4BAA4B,CAAC,CAoEvC"}

package/dist/observability/observability-readiness.js

@@ -0,0 +1,141 @@
+const DEFAULT_OBSERVABILITY_READINESS_PROBE_TIMEOUT_MS = 1_000;
+function formatHttpHost(host) {
+    return host === '::1' ? '[::1]' : host;
+}
+function createHealthEndpoints(config) {
+    const host = formatHttpHost(config.bindAddress);
+    const collectorEndpoint = {
+        name: 'collector',
+        url: `http://${host}:${String(config.ports.collectorHealth)}/`,
+    };
+    if (config.stackMode === 'external') {
+        return [collectorEndpoint];
+    }
+    return [
+        collectorEndpoint,
+        {
+            name: 'victoria-metrics',
+            url: `http://${host}:${String(config.ports.metrics)}/health`,
+        },
+        {
+            name: 'victoria-logs',
+            url: `http://${host}:${String(config.ports.logs)}/health`,
+        },
+        {
+            name: 'victoria-traces',
+            url: `http://${host}:${String(config.ports.traces)}/health`,
+        },
+    ];
+}
+function readErrorCauseCode(error) {
+    const cause = error.cause;
+    if (typeof cause !== 'object' || cause === null || !('code' in cause)) {
+        return undefined;
+    }
+    const code = cause.code;
+    return typeof code === 'string' && code.length > 0 ? code : undefined;
+}
+function formatReadinessError(error) {
+    if (!(error instanceof Error)) {
+        return String(error);
+    }
+    const causeCode = readErrorCauseCode(error);
+    return causeCode === undefined ? error.message : `${error.message} (${causeCode})`;
+}
+function computeProbeTimeoutMs(options) {
+    return Math.max(1, Math.min(options.maxProbeTimeoutMs, options.deadlineMs - options.nowMs));
+}
+async function probeCollectorOtlpHttpReceiver(options) {
+    const host = formatHttpHost(options.config.bindAddress);
+    try {
+        const response = await options.fetchImpl(`http://${host}:${String(options.config.ports.collectorHttp)}/v1/logs`, {
+            body: '{"resourceLogs":[]}',
+            headers: { 'content-type': 'application/json' },
+            method: 'POST',
+            signal: AbortSignal.timeout(options.timeoutMs),
+        });
+        if (response.ok) {
+            return { ok: true };
+        }
+        return {
+            ok: false,
+            reason: `returned HTTP ${String(response.status)}`,
+        };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            reason: formatReadinessError(error),
+        };
+    }
+}
+export async function checkObservabilityStackReadiness(options) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const probeTimeoutMs = options.probeTimeoutMs ?? DEFAULT_OBSERVABILITY_READINESS_PROBE_TIMEOUT_MS;
+    const retryDelayMs = options.retryDelayMs ?? 100;
+    const healthEndpoints = createHealthEndpoints(options.config);
+    const deadlineMs = Date.now() + options.config.startupCheckTimeoutMs;
+    let lastErrorReason = 'observability health checks did not complete';
+    try {
+        for (;;) {
+            let ready = true;
+            for (const endpoint of healthEndpoints) {
+                const currentProbeTimeoutMs = computeProbeTimeoutMs({
+                    deadlineMs,
+                    maxProbeTimeoutMs: probeTimeoutMs,
+                    nowMs: Date.now(),
+                });
+                try {
+                    // oxlint-disable-next-line no-await-in-loop -- bounded readiness checks must preserve failure attribution
+                    const response = await fetchImpl(endpoint.url, {
+                        signal: AbortSignal.timeout(currentProbeTimeoutMs),
+                    });
+                    if (!response.ok) {
+                        ready = false;
+                        lastErrorReason = `${endpoint.name} health check returned HTTP ${String(response.status)}`;
+                        break;
+                    }
+                }
+                catch (error) {
+                    ready = false;
+                    lastErrorReason = `${endpoint.name} health check failed: ${formatReadinessError(error)}`;
+                    if (endpoint.name === 'collector') {
+                        // oxlint-disable-next-line no-await-in-loop -- collector fallback must preserve the failed health-check attribution before continuing.
+                        const collectorOtlpProbeResult = await probeCollectorOtlpHttpReceiver({
+                            config: options.config,
+                            fetchImpl,
+                            timeoutMs: computeProbeTimeoutMs({
+                                deadlineMs,
+                                maxProbeTimeoutMs: probeTimeoutMs,
+                                nowMs: Date.now(),
+                            }),
+                        });
+                        if (collectorOtlpProbeResult.ok) {
+                            ready = true;
+                            continue;
+                        }
+                        lastErrorReason = `${lastErrorReason}; OTLP HTTP fallback failed: ${collectorOtlpProbeResult.reason}`;
+                    }
+                    break;
+                }
+            }
+            if (ready) {
+                return { ok: true, status: 'ready' };
+            }
+            if (Date.now() >= deadlineMs) {
+                break;
+            }
+            // oxlint-disable-next-line no-await-in-loop -- bounded readiness polling for transient port binding races
+            await new Promise((resolve) => setTimeout(resolve, retryDelayMs));
+        }
+    }
+    catch (error) {
+        lastErrorReason = error instanceof Error ? error.message : String(error);
+    }
+    return {
+        ok: false,
+        reason: lastErrorReason,
+        status: 'unavailable',
+    };
+}
+//# sourceMappingURL=observability-readiness.js.map