@omnitron-dev/omnitron 0.1.1

package/dist/infrastructure/types.d.ts

@@ -0,0 +1,413 @@
+/**
+ * Infrastructure Types — Declarative infrastructure definitions
+ *
+ * These types describe the desired state of infrastructure services
+ * (PostgreSQL, Redis, MinIO, etc.) that Omnitron provisions and manages
+ * via Docker containers. They form the infrastructure section of
+ * omnitron.config.ts.
+ */
+export interface PostgresServiceConfig {
+    image?: string;
+    port?: number;
+    databases: Record<string, PostgresDatabaseConfig>;
+    user?: string;
+    password?: string | SecretRef;
+    config?: {
+        maxConnections?: number;
+        sharedBuffers?: string;
+        effectiveCacheSize?: string;
+        workMem?: string;
+        maintenanceWorkMem?: string;
+        logMinDurationStatement?: number;
+    };
+    resources?: ResourceLimits;
+}
+export interface PostgresDatabaseConfig {
+    /** Override user/password for this specific database */
+    user?: string;
+    password?: string | SecretRef;
+    /** Run migrations on startup */
+    migrate?: boolean;
+    /** Migration directory relative to app root */
+    migrationDir?: string;
+}
+export interface RedisServiceConfig {
+    image?: string;
+    port?: number;
+    password?: string | SecretRef;
+    config?: {
+        maxmemory?: string;
+        maxmemoryPolicy?: string;
+        appendonly?: boolean;
+    };
+    /** Named DB allocations: { main: 0, storage: 1, messaging: 2 } */
+    databases?: Record<string, number>;
+    resources?: ResourceLimits;
+}
+export interface MinioServiceConfig {
+    image?: string;
+    ports?: {
+        api?: number;
+        console?: number;
+    };
+    accessKey?: string;
+    secretKey?: string | SecretRef;
+    buckets?: string[];
+    resources?: ResourceLimits;
+}
+export interface GatewayServiceConfig {
+    image?: string;
+    port?: number;
+    /** Path to gateway config directory (relative to project root), containing nginx.conf, lua/, maintenance.html */
+    configDir?: string;
+    /** Redis DB index for gateway state — auto-allocated by omnitron (set internally, NOT in user config) */
+    redisDb?: number;
+    /** Auto-generated from app transport definitions if not specified */
+    customConfig?: string;
+    resources?: ResourceLimits;
+}
+export interface TorServiceConfig {
+    image?: string;
+    /** Map of virtual port → target host:port */
+    hiddenServicePorts?: Record<number, string>;
+    resources?: ResourceLimits;
+}
+export interface GenericContainerConfig {
+    image: string;
+    ports?: Record<string, number>;
+    environment?: Record<string, string>;
+    volumes?: string[];
+    command?: string[];
+    healthCheck?: ContainerHealthCheck;
+    resources?: ResourceLimits;
+    dependsOn?: string[];
+}
+export interface InfrastructureConfig {
+    /**
+     * Unified services map — the canonical way to declare infrastructure.
+     * Each key is a logical service name. Values are either:
+     * - IServiceRequirement (full custom definition)
+     * - IPresetServiceConfig (shorthand referencing a registered preset)
+     *
+     * Example:
+     * ```typescript
+     * services: {
+     *   db: { preset: 'postgres', config: { databases: { main: {}, storage: {} } } },
+     *   cache: { preset: 'redis' },
+     *   storage: { preset: 'minio', config: { buckets: ['uploads'] } },
+     *   gateway: { preset: 'openresty', config: { configDir: './infra/nginx' } },
+     * }
+     * ```
+     */
+    services?: Record<string, IServiceRequirement | import('./presets/types.js').IPresetServiceConfig>;
+    postgres?: PostgresServiceConfig;
+    redis?: RedisServiceConfig;
+    minio?: MinioServiceConfig;
+    gateway?: GatewayServiceConfig;
+    tor?: TorServiceConfig;
+    containers?: Record<string, GenericContainerConfig>;
+}
+export type ContainerStatus = 'not_found' | 'created' | 'running' | 'paused' | 'restarting' | 'exited' | 'dead';
+export interface ContainerState {
+    name: string;
+    image: string;
+    status: ContainerStatus;
+    containerId?: string | undefined;
+    ports?: Record<string, number> | undefined;
+    health?: 'healthy' | 'unhealthy' | 'starting' | 'none' | undefined;
+    startedAt?: string | undefined;
+    error?: string | undefined;
+}
+export interface InfrastructureState {
+    services: Record<string, ContainerState>;
+    ready: boolean;
+    lastReconciled?: string;
+}
+export interface SecretRef {
+    /** Secret key name in the secrets store */
+    secret: string;
+}
+export interface ResourceLimits {
+    memory?: string;
+    memoryReservation?: string;
+    cpus?: number;
+    shmSize?: string;
+}
+export interface ContainerHealthCheck {
+    test: string[];
+    interval?: string;
+    timeout?: string;
+    retries?: number;
+    startPeriod?: string;
+}
+/**
+ * Declares what an app needs from an infrastructure service,
+ * independent of how it is provisioned.
+ *
+ * Apps declare these in config/default.json under `omnitron.infrastructure`.
+ * The active stack decides whether to provision via Docker, bare-metal, or
+ * connect to an external service.
+ */
+export interface IServiceRequirement {
+    /** Human-readable description. Shown in `omnitron status --infra`. */
+    description?: string;
+    /**
+     * Service type category. Affects default provisioning behavior.
+     * - 'database': Data persistence (gets volumes, backup policies)
+     * - 'cache': Ephemeral data (may skip volumes)
+     * - 'daemon': Long-running process (blockchain nodes, queue brokers)
+     * - 'sidecar': Lightweight helper (proxies, adapters)
+     * - 'tool': Run-once or periodic (migrations, seeders)
+     */
+    type?: 'database' | 'cache' | 'daemon' | 'gateway' | 'storage' | 'sidecar' | 'tool';
+    /**
+     * Named ports this service exposes.
+     * Keys are logical names, values are the default port numbers.
+     * The provisioner maps these to actual endpoints.
+     */
+    ports: Record<string, number>;
+    /**
+     * Environment variables to inject into the APP (not the service container).
+     * Values can reference resolved service properties using templates:
+     *   ${host}          — resolved hostname/IP
+     *   ${port:rpc}      — resolved port for the named port 'rpc'
+     *   ${secret:name}   — resolved secret value
+     */
+    env: Record<string, string>;
+    /** Health check definition. */
+    healthCheck?: IServiceHealthCheck;
+    /**
+     * Services this service depends on (by logical name).
+     * Provisioner ensures dependencies start first and are healthy.
+     */
+    dependsOn?: string[];
+    /**
+     * Secrets this service needs. Keys are logical names.
+     * Referenced in env templates as ${secret:keyName}.
+     * Values: literal strings (dev) or SecretRef (prod).
+     */
+    secrets?: Record<string, string | SecretRef>;
+    /**
+     * Docker provisioning — used for dev/test stacks.
+     * If omitted, service must be provisioned externally.
+     */
+    docker?: IDockerServiceConfig;
+    /** Bare-metal provisioning hints — used for prod stacks. */
+    bareMetal?: IBareMetalServiceConfig;
+    /** Version constraint (semver range). */
+    version?: string;
+    /**
+     * Network mode — domain-specific, interpreted by the service.
+     * Selects the matching variant from docker/bareMetal configs.
+     * @example 'regtest' | 'testnet' | 'mainnet' | 'stagenet'
+     */
+    networkMode?: string;
+    /** If true, app will not start until this service is healthy. Default: true. */
+    critical?: boolean;
+    /** Startup timeout in ms. Default: 120_000. */
+    startupTimeout?: number;
+    /** @internal Preset name that generated this requirement (set by PresetRegistry.expand) */
+    _preset?: string;
+    /** @internal User config passed to preset (for postProvision hooks) */
+    _presetConfig?: Record<string, unknown>;
+}
+/**
+ * Docker-specific provisioning for a custom service.
+ */
+export interface IDockerServiceConfig {
+    /** Docker image. Required unless `build` is specified. */
+    image?: string;
+    /** Build context for building from Dockerfile. Paths relative to app root. */
+    build?: {
+        context: string;
+        dockerfile?: string;
+        args?: Record<string, string>;
+        /** Pre-built image tag. If exists, skip build. */
+        tag?: string;
+    };
+    /**
+     * Host port overrides. Keys match port names in IServiceRequirement.ports.
+     * If not specified, host ports = container ports.
+     */
+    portMappings?: Record<string, number>;
+    /** Bind host side of port mappings. Default: '127.0.0.1'. */
+    bindHost?: string;
+    /** Container environment variables (for the SERVICE, not the app). */
+    environment?: Record<string, string>;
+    /**
+     * Named volumes. Auto-prefixed with stack container prefix.
+     * String value = mount path. Object = full mount spec.
+     */
+    volumes?: Record<string, string | IVolumeMount>;
+    /** Container command override. */
+    command?: string[];
+    /** Container entrypoint override. */
+    entrypoint?: string[];
+    /** Container user. */
+    user?: string;
+    /** Docker health check (overrides IServiceRequirement.healthCheck). */
+    healthCheck?: ContainerHealthCheck;
+    /** Resource limits. */
+    resources?: ResourceLimits;
+    /** Restart policy. Default: 'unless-stopped'. */
+    restart?: string;
+    /** Shared memory size. */
+    shmSize?: string;
+    /** Docker network to join. */
+    network?: string | IDockerNetworkConfig;
+    /** Extra Docker labels. */
+    labels?: Record<string, string>;
+    /**
+     * Variants keyed by networkMode. When IServiceRequirement.networkMode
+     * matches a key, the variant is deep-merged over the base config.
+     */
+    variants?: Record<string, Partial<Omit<IDockerServiceConfig, 'variants'>>>;
+}
+export interface IVolumeMount {
+    /** Host path (bind mount) or named volume name. */
+    source: string;
+    /** Container path. */
+    target: string;
+    /** Read-only mount. */
+    readonly?: boolean;
+}
+export interface IDockerNetworkConfig {
+    name: string;
+    driver?: 'bridge' | 'host' | 'overlay';
+    subnet?: string;
+    gateway?: string;
+    ipv4Address?: string;
+}
+/**
+ * Bare-metal provisioning hints for production deployments.
+ */
+export interface IBareMetalServiceConfig {
+    /** Package install command. */
+    installCommand?: string;
+    /** Systemd service name. */
+    systemdUnit?: string;
+    /** Config file path on target machine. */
+    configFile?: string;
+    /** Template for the config file (uses ${...} syntax). */
+    configTemplate?: string;
+    /** Data directory. Omnitron ensures it exists with correct permissions. */
+    dataDir?: string;
+    /** User to run the service as. */
+    user?: string;
+    /** Bind address for remote/cluster stacks. */
+    bindAddress?: string;
+    /** Validation command to check if service is installed. */
+    validateCommand?: string;
+    /** Variants keyed by networkMode. */
+    variants?: Record<string, Partial<Omit<IBareMetalServiceConfig, 'variants'>>>;
+}
+/**
+ * Health check definition — provisioner-agnostic.
+ */
+export interface IServiceHealthCheck {
+    /**
+     * Check type:
+     * - 'http': HTTP GET, expect 2xx
+     * - 'tcp': TCP connect to port
+     * - 'command': Shell command, check exit code
+     * - 'jsonrpc': JSON-RPC call (for blockchain daemons)
+     */
+    type: 'http' | 'tcp' | 'command' | 'jsonrpc';
+    /**
+     * For 'http': URL path. For 'tcp': port name.
+     * For 'command': shell command. For 'jsonrpc': method name.
+     */
+    target: string;
+    /** Interval between checks. Default: '30s'. */
+    interval?: string;
+    /** Timeout per check. Default: '10s'. */
+    timeout?: string;
+    /** Consecutive failures before unhealthy. Default: 5. */
+    retries?: number;
+    /** Grace period before first check. Default: '30s'. */
+    startPeriod?: string;
+    /** JSON-RPC specific config. */
+    jsonrpc?: {
+        port: string;
+        method: string;
+        auth?: {
+            user: string;
+            password: string;
+            type?: 'digest' | 'basic';
+        };
+    };
+}
+/**
+ * Stack-level service override. Lets a stack redirect an app-declared
+ * service to an external provider or customize Docker config.
+ */
+export interface IServiceOverride {
+    /** External service — skip provisioning, just connect. */
+    external?: {
+        host: string;
+        ports: Record<string, number>;
+        secrets?: Record<string, string | SecretRef>;
+    };
+    /** Override Docker config for this stack. Deep-merged over app declaration. */
+    docker?: Partial<IDockerServiceConfig>;
+    /** Override bare-metal config. */
+    bareMetal?: Partial<IBareMetalServiceConfig>;
+    /** Disable this service in this stack. */
+    disabled?: boolean;
+}
+/**
+ * Resolved address for a custom service — used by config resolver
+ * to generate env vars from templates.
+ */
+export interface IResolvedServiceAddress {
+    host: string;
+    ports: Record<string, number>;
+    secrets?: Record<string, string>;
+}
+export type ReconcileAction = {
+    type: 'create';
+    service: string;
+    config: ResolvedContainer;
+} | {
+    type: 'start';
+    service: string;
+    containerId: string;
+} | {
+    type: 'recreate';
+    service: string;
+    config: ResolvedContainer;
+    reason: string;
+} | {
+    type: 'remove';
+    service: string;
+    containerId: string;
+} | {
+    type: 'noop';
+    service: string;
+};
+export interface ResolvedContainer {
+    name: string;
+    image: string;
+    ports: Array<{
+        host: number;
+        container: number;
+    }>;
+    environment: Record<string, string>;
+    volumes: Array<{
+        source: string;
+        target: string;
+        readonly?: boolean;
+    }>;
+    command?: string[] | undefined;
+    entrypoint?: string[] | undefined;
+    /** If false, provisioning continues without waiting for this container to be healthy. */
+    critical?: boolean;
+    healthCheck?: ContainerHealthCheck | undefined;
+    labels: Record<string, string>;
+    restart: string;
+    shmSize?: string | undefined;
+    resources?: ResourceLimits | undefined;
+    /** Extra /etc/hosts entries (e.g., 'host.docker.internal:host-gateway') */
+    extraHosts?: string[] | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/infrastructure/types.d.ts.map

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

package/dist/infrastructure/types.js

@@ -0,0 +1,10 @@
+/**
+ * Infrastructure Types — Declarative infrastructure definitions
+ *
+ * These types describe the desired state of infrastructure services
+ * (PostgreSQL, Redis, MinIO, etc.) that Omnitron provisions and manages
+ * via Docker containers. They form the infrastructure section of
+ * omnitron.config.ts.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/infrastructure/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/infrastructure/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/mcp/mcp-bridge.d.ts

@@ -0,0 +1,21 @@
+import type { IMcpToolDef } from './types.js';
+/**
+ * MCP stdio bridge — implements the Model Context Protocol over stdin/stdout.
+ * Minimal implementation that handles tool listing and invocation.
+ *
+ * Protocol: JSON-RPC 2.0 over newline-delimited JSON on stdin/stdout.
+ */
+export declare class McpBridge {
+    private tools;
+    registerTools(tools: IMcpToolDef[]): void;
+    /**
+     * Start the MCP stdio server.
+     * Reads JSON-RPC messages from stdin, dispatches to tool handlers,
+     * writes responses to stdout.
+     */
+    start(): Promise<void>;
+    private handleMessage;
+    private send;
+    private sendError;
+}
+//# sourceMappingURL=mcp-bridge.d.ts.map

package/dist/mcp/mcp-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-bridge.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAAkC;IAE/C,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,IAAI;IAMzC;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAwBd,aAAa;IAkF3B,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,SAAS;CAOlB"}

package/dist/mcp/mcp-bridge.js

@@ -0,0 +1,126 @@
+/**
+ * MCP stdio bridge — implements the Model Context Protocol over stdin/stdout.
+ * Minimal implementation that handles tool listing and invocation.
+ *
+ * Protocol: JSON-RPC 2.0 over newline-delimited JSON on stdin/stdout.
+ */
+export class McpBridge {
+    tools = new Map();
+    registerTools(tools) {
+        for (const tool of tools) {
+            this.tools.set(tool.name, tool);
+        }
+    }
+    /**
+     * Start the MCP stdio server.
+     * Reads JSON-RPC messages from stdin, dispatches to tool handlers,
+     * writes responses to stdout.
+     */
+    async start() {
+        const { createInterface } = await import('node:readline');
+        const rl = createInterface({ input: process.stdin });
+        // Send server info on connect
+        this.send({
+            jsonrpc: '2.0',
+            method: 'notifications/initialized',
+            params: {},
+        });
+        for await (const line of rl) {
+            if (!line.trim())
+                continue;
+            try {
+                const message = JSON.parse(line);
+                await this.handleMessage(message);
+            }
+            catch (err) {
+                this.sendError(null, -32700, 'Parse error');
+            }
+        }
+    }
+    async handleMessage(message) {
+        const { id, method, params } = message;
+        switch (method) {
+            case 'initialize':
+                this.send({
+                    jsonrpc: '2.0',
+                    id,
+                    result: {
+                        protocolVersion: '2024-11-05',
+                        capabilities: { tools: {} },
+                        serverInfo: {
+                            name: 'omnitron',
+                            version: '0.1.0',
+                        },
+                    },
+                });
+                break;
+            case 'tools/list':
+                this.send({
+                    jsonrpc: '2.0',
+                    id,
+                    result: {
+                        tools: [...this.tools.values()].map(t => ({
+                            name: t.name,
+                            description: t.description,
+                            inputSchema: t.inputSchema,
+                        })),
+                    },
+                });
+                break;
+            case 'tools/call': {
+                const toolName = params?.name;
+                const tool = this.tools.get(toolName);
+                if (!tool) {
+                    this.sendError(id, -32601, `Unknown tool: ${toolName}`);
+                    return;
+                }
+                try {
+                    const result = await tool.handler(params?.arguments ?? {});
+                    this.send({
+                        jsonrpc: '2.0',
+                        id,
+                        result: {
+                            content: [{
+                                    type: 'text',
+                                    text: typeof result === 'string' ? result : JSON.stringify(result, null, 2),
+                                }],
+                        },
+                    });
+                }
+                catch (err) {
+                    this.send({
+                        jsonrpc: '2.0',
+                        id,
+                        result: {
+                            content: [{
+                                    type: 'text',
+                                    text: `Error: ${err.message ?? String(err)}`,
+                                }],
+                            isError: true,
+                        },
+                    });
+                }
+                break;
+            }
+            case 'notifications/initialized':
+            case 'notifications/cancelled':
+                // No response needed for notifications
+                break;
+            default:
+                if (id !== undefined) {
+                    this.sendError(id, -32601, `Method not found: ${method}`);
+                }
+        }
+    }
+    send(message) {
+        process.stdout.write(JSON.stringify(message) + '\n');
+    }
+    sendError(id, code, message) {
+        this.send({
+            jsonrpc: '2.0',
+            id,
+            error: { code, message },
+        });
+    }
+}
+//# sourceMappingURL=mcp-bridge.js.map

package/dist/mcp/mcp-bridge.js.map

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

package/dist/mcp/tool-groups/apps.tools.d.ts

@@ -0,0 +1,7 @@
+import type { IMcpToolDef } from '../types.js';
+/**
+ * App management MCP tools.
+ * Bridges to DaemonService RPC for app lifecycle management.
+ */
+export declare function createAppsTools(daemonClient: any): IMcpToolDef[];
+//# sourceMappingURL=apps.tools.d.ts.map

package/dist/mcp/tool-groups/apps.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apps.tools.d.ts","sourceRoot":"","sources":["../../../src/mcp/tool-groups/apps.tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;GAGG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,GAAG,GAAG,WAAW,EAAE,CAgGhE"}