@framers/agentos 0.1.119 → 0.1.121

package/dist/rag/setup/DockerDetector.js

@@ -0,0 +1,125 @@
+/**
+ * @fileoverview Docker environment detection and container management.
+ * @module rag/setup/DockerDetector
+ *
+ * Utility class for detecting whether Docker is available, checking
+ * container state, starting/stopping containers, and pulling images.
+ * Used by QdrantSetup and PostgresSetup for auto-provisioning.
+ */
+import { execSync } from 'node:child_process';
+export class DockerDetector {
+    /**
+     * Check if Docker is installed and the daemon is running.
+     * Runs `docker info` with a 5-second timeout.
+     *
+     * @returns True if Docker is available and responsive.
+     */
+    static isDockerAvailable() {
+        try {
+            execSync('docker info', { stdio: 'pipe', timeout: 5000 });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Check the state of a named Docker container.
+     *
+     * @param name - Container name to inspect.
+     * @returns 'running' if active, 'stopped' if exists but not running,
+     *          'not_found' if the container doesn't exist.
+     */
+    static getContainerState(name) {
+        try {
+            const output = execSync(`docker inspect --format='{{.State.Running}}' "${name}"`, { stdio: 'pipe', timeout: 5000 }).toString().trim();
+            // docker inspect returns 'true' or 'false' for .State.Running
+            return output === 'true' ? 'running' : 'stopped';
+        }
+        catch {
+            // Container doesn't exist or docker not available.
+            return 'not_found';
+        }
+    }
+    /**
+     * Start a stopped container by name.
+     *
+     * @param name - Container name to start.
+     * @throws If the container cannot be started.
+     */
+    static startContainer(name) {
+        execSync(`docker start "${name}"`, { stdio: 'pipe', timeout: 15000 });
+    }
+    /**
+     * Pull a Docker image and run a new container.
+     *
+     * @param opts.name    - Container name.
+     * @param opts.image   - Docker image (e.g. 'qdrant/qdrant:latest').
+     * @param opts.ports   - Port mappings (e.g. ['6333:6333', '6334:6334']).
+     * @param opts.volumes - Volume mounts (e.g. ['data-vol:/data']).
+     * @param opts.env     - Environment variables (e.g. { POSTGRES_PASSWORD: 'pw' }).
+     */
+    static pullAndRun(opts) {
+        // Pull the image first (allows progress output via pipe).
+        execSync(`docker pull "${opts.image}"`, { stdio: 'pipe', timeout: 120000 });
+        // Build the docker run command.
+        const portFlags = opts.ports.map(p => `-p ${p}`).join(' ');
+        const volFlags = opts.volumes.map(v => `-v ${v}`).join(' ');
+        const envFlags = opts.env
+            ? Object.entries(opts.env).map(([k, v]) => `-e "${k}=${v}"`).join(' ')
+            : '';
+        const cmd = [
+            'docker run -d',
+            `--name "${opts.name}"`,
+            portFlags,
+            volFlags,
+            envFlags,
+            `"${opts.image}"`,
+        ].filter(Boolean).join(' ');
+        execSync(cmd, { stdio: 'pipe', timeout: 30000 });
+    }
+    /**
+     * Poll a health check URL until it returns 200 or timeout is reached.
+     * Checks every 500ms.
+     *
+     * @param url       - Health check endpoint (e.g. 'http://localhost:6333/healthz').
+     * @param timeoutMs - Maximum time to wait in milliseconds. @default 15000
+     * @returns True if the endpoint became healthy within the timeout.
+     */
+    static async waitForHealthy(url, timeoutMs = 15000) {
+        const start = Date.now();
+        while (Date.now() - start < timeoutMs) {
+            try {
+                const res = await fetch(url);
+                if (res.ok)
+                    return true;
+            }
+            catch {
+                // Not ready yet — keep polling.
+            }
+            await new Promise(r => setTimeout(r, 500));
+        }
+        return false;
+    }
+    /**
+     * Get the mapped host port for a container's internal port.
+     * Useful when the host port was dynamically assigned.
+     *
+     * @param name         - Container name.
+     * @param internalPort - The container-internal port to look up.
+     * @returns The host port number, or null if not found.
+     */
+    static getHostPort(name, internalPort) {
+        try {
+            const output = execSync(`docker port "${name}" ${internalPort}`, { stdio: 'pipe', timeout: 5000 }).toString().trim();
+            // Output format: "0.0.0.0:6333" or ":::6333"
+            const parts = output.split(':');
+            const port = parseInt(parts[parts.length - 1], 10);
+            return isNaN(port) ? null : port;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=DockerDetector.js.map

package/dist/rag/setup/DockerDetector.js.map

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

package/dist/rag/setup/PostgresSetup.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview Postgres + pgvector auto-setup via Docker detection.
+ * @module rag/setup/PostgresSetup
+ *
+ * Detection flow:
+ * 1. Check DATABASE_URL / explicit connection string → pg_isready
+ * 2. Check Docker → existing container → start if stopped
+ * 3. Pull postgres:16 → run new container → install pgvector extension
+ */
+import type { BackendStatus, SetupConfig } from './types.js';
+export declare class PostgresSetup {
+    /**
+     * Detect and optionally provision a Postgres + pgvector instance.
+     *
+     * @param config - Optional setup overrides (port, image tag, URL).
+     * @returns Backend status with connection string.
+     */
+    static detect(config?: SetupConfig): Promise<BackendStatus>;
+}
+//# sourceMappingURL=PostgresSetup.d.ts.map

package/dist/rag/setup/PostgresSetup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresSetup.d.ts","sourceRoot":"","sources":["../../../src/rag/setup/PostgresSetup.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAa7D,qBAAa,aAAa;IACxB;;;;;OAKG;WACU,MAAM,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;CA8GlE"}

package/dist/rag/setup/PostgresSetup.js

@@ -0,0 +1,133 @@
+/**
+ * @fileoverview Postgres + pgvector auto-setup via Docker detection.
+ * @module rag/setup/PostgresSetup
+ *
+ * Detection flow:
+ * 1. Check DATABASE_URL / explicit connection string → pg_isready
+ * 2. Check Docker → existing container → start if stopped
+ * 3. Pull postgres:16 → run new container → install pgvector extension
+ */
+import { DockerDetector } from './DockerDetector.js';
+/** Default container name for Wunderland-managed Postgres. */
+const CONTAINER_NAME = 'wunderland-postgres';
+/** Default port. */
+const DEFAULT_PORT = 5432;
+/** Default Docker image. */
+const IMAGE = 'postgres';
+/** Default password for auto-provisioned instances. */
+const DEFAULT_PASSWORD = 'wunderland';
+/** Default database name. */
+const DEFAULT_DB = 'agent_memory';
+export class PostgresSetup {
+    /**
+     * Detect and optionally provision a Postgres + pgvector instance.
+     *
+     * @param config - Optional setup overrides (port, image tag, URL).
+     * @returns Backend status with connection string.
+     */
+    static async detect(config) {
+        const port = config?.port ?? DEFAULT_PORT;
+        // ── Step 1: Check explicit connection string or env var ──
+        const connStr = config?.url ?? process.env.DATABASE_URL;
+        if (connStr) {
+            try {
+                const pg = await import('pg');
+                const client = new pg.default.Client({ connectionString: connStr });
+                await client.connect();
+                // Check if pgvector is installed.
+                try {
+                    await client.query("SELECT extname FROM pg_extension WHERE extname = 'vector'");
+                }
+                catch {
+                    // pgvector not installed — try to install it.
+                    await client.query('CREATE EXTENSION IF NOT EXISTS vector');
+                }
+                await client.end();
+                // Detect cloud providers from connection string.
+                const isCloud = /neon|supabase|rds\.amazonaws|aiven/i.test(connStr);
+                return { status: 'running', url: connStr, source: isCloud ? 'cloud' : 'manual' };
+            }
+            catch (err) {
+                return {
+                    status: 'error',
+                    url: connStr,
+                    error: `Cannot connect to Postgres: ${err instanceof Error ? err.message : String(err)}`,
+                };
+            }
+        }
+        // ── Step 2: Check Docker availability ──
+        if (!DockerDetector.isDockerAvailable()) {
+            return {
+                status: 'no_docker',
+                error: 'Docker not found. Install Docker to auto-provision Postgres: https://docker.com/get-docker',
+            };
+        }
+        // ── Step 3: Check existing container ──
+        const localConnStr = `postgresql://postgres:${DEFAULT_PASSWORD}@localhost:${port}/${DEFAULT_DB}`;
+        const state = DockerDetector.getContainerState(CONTAINER_NAME);
+        if (state === 'running') {
+            return {
+                status: 'running',
+                url: localConnStr,
+                containerName: CONTAINER_NAME,
+                source: 'docker-local',
+            };
+        }
+        if (state === 'stopped') {
+            DockerDetector.startContainer(CONTAINER_NAME);
+            // Postgres needs a few seconds to accept connections after start.
+            await new Promise(r => setTimeout(r, 3000));
+            return {
+                status: 'running',
+                url: localConnStr,
+                containerName: CONTAINER_NAME,
+                source: 'docker-local',
+            };
+        }
+        // ── Step 4: Pull and run new container ──
+        const tag = config?.imageTag ?? '16';
+        try {
+            DockerDetector.pullAndRun({
+                name: CONTAINER_NAME,
+                image: `${IMAGE}:${tag}`,
+                ports: [`${port}:5432`],
+                volumes: ['wunderland-pg-data:/var/lib/postgresql/data'],
+                env: {
+                    POSTGRES_DB: DEFAULT_DB,
+                    POSTGRES_PASSWORD: DEFAULT_PASSWORD,
+                },
+            });
+        }
+        catch (err) {
+            return {
+                status: 'error',
+                error: `Failed to start Postgres container: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+        // Wait for Postgres to accept connections.
+        await new Promise(r => setTimeout(r, 5000));
+        // ── Step 5: Install pgvector extension ──
+        try {
+            const pg = await import('pg');
+            const client = new pg.default.Client({ connectionString: localConnStr });
+            await client.connect();
+            await client.query('CREATE EXTENSION IF NOT EXISTS vector');
+            await client.end();
+        }
+        catch (err) {
+            return {
+                status: 'error',
+                url: localConnStr,
+                containerName: CONTAINER_NAME,
+                error: `Postgres running but pgvector install failed: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+        return {
+            status: 'running',
+            url: localConnStr,
+            containerName: CONTAINER_NAME,
+            source: 'docker-local',
+        };
+    }
+}
+//# sourceMappingURL=PostgresSetup.js.map

package/dist/rag/setup/PostgresSetup.js.map

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

package/dist/rag/setup/QdrantSetup.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview Qdrant auto-setup via Docker detection and provisioning.
+ * @module rag/setup/QdrantSetup
+ *
+ * Detection flow:
+ * 1. Check QDRANT_URL / explicit URL → health check
+ * 2. Check Docker → existing container → start if stopped
+ * 3. Pull qdrant/qdrant image → run new container
+ * 4. Poll /healthz until ready
+ */
+import type { BackendStatus, SetupConfig } from './types.js';
+export declare class QdrantSetup {
+    /**
+     * Detect and optionally provision a Qdrant instance.
+     *
+     * Priority order:
+     * 1. Explicit URL or QDRANT_URL env var → direct health check
+     * 2. Docker container named 'wunderland-qdrant' → start if stopped
+     * 3. Pull and run a new Docker container
+     *
+     * @param config - Optional setup overrides (port, image tag, URL, API key).
+     * @returns Backend status with URL and connection details.
+     */
+    static detect(config?: SetupConfig): Promise<BackendStatus>;
+}
+//# sourceMappingURL=QdrantSetup.d.ts.map

package/dist/rag/setup/QdrantSetup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QdrantSetup.d.ts","sourceRoot":"","sources":["../../../src/rag/setup/QdrantSetup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAW7D,qBAAa,WAAW;IACtB;;;;;;;;;;OAUG;WACU,MAAM,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;CAoElE"}

package/dist/rag/setup/QdrantSetup.js

@@ -0,0 +1,96 @@
+/**
+ * @fileoverview Qdrant auto-setup via Docker detection and provisioning.
+ * @module rag/setup/QdrantSetup
+ *
+ * Detection flow:
+ * 1. Check QDRANT_URL / explicit URL → health check
+ * 2. Check Docker → existing container → start if stopped
+ * 3. Pull qdrant/qdrant image → run new container
+ * 4. Poll /healthz until ready
+ */
+import { DockerDetector } from './DockerDetector.js';
+/** Default container name for Wunderland-managed Qdrant. */
+const CONTAINER_NAME = 'wunderland-qdrant';
+/** Default Qdrant REST API port. */
+const DEFAULT_PORT = 6333;
+/** Default Qdrant gRPC port. */
+const DEFAULT_GRPC_PORT = 6334;
+/** Default Docker image. */
+const IMAGE = 'qdrant/qdrant';
+export class QdrantSetup {
+    /**
+     * Detect and optionally provision a Qdrant instance.
+     *
+     * Priority order:
+     * 1. Explicit URL or QDRANT_URL env var → direct health check
+     * 2. Docker container named 'wunderland-qdrant' → start if stopped
+     * 3. Pull and run a new Docker container
+     *
+     * @param config - Optional setup overrides (port, image tag, URL, API key).
+     * @returns Backend status with URL and connection details.
+     */
+    static async detect(config) {
+        const port = config?.port ?? DEFAULT_PORT;
+        // ── Step 1: Check explicit URL or env var ──
+        const url = config?.url ?? process.env.QDRANT_URL;
+        if (url) {
+            try {
+                const res = await fetch(`${url.replace(/\/+$/, '')}/healthz`);
+                if (res.ok) {
+                    // Determine if this is a cloud instance based on URL.
+                    const isCloud = url.includes('cloud.qdrant.io') || !!config?.apiKey;
+                    return { status: 'running', url, source: isCloud ? 'cloud' : 'manual' };
+                }
+            }
+            catch {
+                return { status: 'error', url, error: `Cannot reach Qdrant at ${url}` };
+            }
+        }
+        // ── Step 2: Check Docker availability ──
+        if (!DockerDetector.isDockerAvailable()) {
+            return {
+                status: 'no_docker',
+                error: 'Docker not found. Install Docker to auto-provision Qdrant: https://docker.com/get-docker',
+            };
+        }
+        // ── Step 3: Check existing container ──
+        const state = DockerDetector.getContainerState(CONTAINER_NAME);
+        const localUrl = `http://localhost:${port}`;
+        if (state === 'running') {
+            return {
+                status: 'running',
+                url: localUrl,
+                containerName: CONTAINER_NAME,
+                source: 'docker-local',
+            };
+        }
+        if (state === 'stopped') {
+            DockerDetector.startContainer(CONTAINER_NAME);
+            const healthy = await DockerDetector.waitForHealthy(`${localUrl}/healthz`);
+            return healthy
+                ? { status: 'running', url: localUrl, containerName: CONTAINER_NAME, source: 'docker-local' }
+                : { status: 'error', containerName: CONTAINER_NAME, error: 'Qdrant container started but health check timed out' };
+        }
+        // ── Step 4: Pull and run new container ──
+        const tag = config?.imageTag ?? 'latest';
+        try {
+            DockerDetector.pullAndRun({
+                name: CONTAINER_NAME,
+                image: `${IMAGE}:${tag}`,
+                ports: [`${port}:${DEFAULT_PORT}`, `${port + 1}:${DEFAULT_GRPC_PORT}`],
+                volumes: ['wunderland-qdrant-data:/qdrant/storage'],
+            });
+        }
+        catch (err) {
+            return {
+                status: 'error',
+                error: `Failed to start Qdrant container: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+        const healthy = await DockerDetector.waitForHealthy(`${localUrl}/healthz`, 20000);
+        return healthy
+            ? { status: 'running', url: localUrl, containerName: CONTAINER_NAME, source: 'docker-local' }
+            : { status: 'error', containerName: CONTAINER_NAME, error: 'Qdrant container created but health check timed out' };
+    }
+}
+//# sourceMappingURL=QdrantSetup.js.map

package/dist/rag/setup/QdrantSetup.js.map

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

package/dist/rag/setup/types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @fileoverview Types for backend auto-setup and Docker detection.
+ * @module rag/setup/types
+ */
+/** Status of a backend detection attempt. */
+export type SetupStatus = 'running' | 'stopped' | 'not_found' | 'no_docker' | 'error';
+/**
+ * Result of detecting a backend's availability.
+ */
+export interface BackendStatus {
+    /** Current status of the backend. */
+    status: SetupStatus;
+    /** URL/connection string if the backend is reachable. */
+    url?: string;
+    /** Docker container name if running via Docker. */
+    containerName?: string;
+    /** How the backend was discovered. */
+    source?: 'docker-local' | 'env-var' | 'cloud' | 'manual';
+    /** Error message if status is 'error' or 'no_docker'. */
+    error?: string;
+}
+/**
+ * Configuration for auto-setup operations.
+ */
+export interface SetupConfig {
+    /** Custom port override. */
+    port?: number;
+    /** Custom Docker image tag (e.g. 'v1.8.0'). */
+    imageTag?: string;
+    /** Skip Docker and connect to this URL directly. */
+    url?: string;
+    /** API key for cloud instances. */
+    apiKey?: string;
+}
+/**
+ * Persisted vector store configuration at ~/.wunderland/vector-store.json.
+ * Written after successful auto-setup, read by all subsequent commands.
+ */
+export interface VectorStoreConfig {
+    /** Backend type. */
+    type: 'sqlite' | 'postgres' | 'qdrant';
+    /** Connection URL (for Postgres/Qdrant). */
+    url?: string;
+    /** File path (for SQLite). */
+    path?: string;
+    /** Postgres connection string. */
+    connectionString?: string;
+    /** How this config was created. */
+    source?: string;
+    /** Docker container name if applicable. */
+    containerName?: string;
+    /** ISO timestamp of when setup was performed. */
+    setupAt?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/rag/setup/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/rag/setup/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,6CAA6C;AAC7C,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,MAAM,EAAE,WAAW,CAAC;IACpB,yDAAyD;IACzD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IACzD,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,oBAAoB;IACpB,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;IACvC,4CAA4C;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/rag/setup/types.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Types for backend auto-setup and Docker detection.
+ * @module rag/setup/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/rag/setup/types.js.map

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