@aikyroon/installer-core 1.0.0

package/dist/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAA4C,MAAM,YAAY,CAAC;AAE1F,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE;QAAE,IAAI,EAAE,aAAa,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACrF;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAiHvF"}

package/dist/install.js

@@ -0,0 +1,217 @@
+import path from 'node:path';
+import fs from 'fs-extra';
+import { getLatestVersionInfo } from './api.js';
+import { defaultApiUrl, defaultInstallRoot, normalizeApiUrl, stripTrailingSep } from './config.js';
+import { downloadAndVerify } from './download.js';
+import { extractArchive, isTarball, locateBinary } from './extract.js';
+import { writeInstalledVersion, writeJsonAtomic } from './manifest.js';
+import { detectPlatform, resolveComponent } from './platform.js';
+import { ensurePythonLauncher } from './python.js';
+import { stopKyroonProcesses } from './processes.js';
+import { createShortcuts } from './shortcuts.js';
+import * as log from './logger.js';
+/**
+ * Installs the requested components "flat" under `<installRoot>/<component>/`,
+ * each with its own copy of the native updater (win/linux/macOS). Mirrors the
+ * launcher-less `install.ps1` flow: detect -> download(+SHA256) -> stop -> python
+ * -> extract -> updater -> manifest -> shortcuts -> activate/start.
+ */
+export async function installComponents(options) {
+    const platform = detectPlatform();
+    const apiUrl = normalizeApiUrl(options.apiUrl ?? defaultApiUrl());
+    const installRoot = stripTrailingSep(options.installRoot ?? defaultInstallRoot(platform));
+    const wantService = options.service ?? true;
+    const wantStart = options.start ?? true;
+    const selected = dedupeComponents(options.components);
+    const specs = selected.map((name) => requireSpec(name, platform));
+    await fs.ensureDir(installRoot);
+    const downloadsDir = path.join(installRoot, 'downloads');
+    await fs.ensureDir(downloadsDir);
+    log.banner('Kyroon Enterprise Installer', [
+        `Platform    : ${platform.slug}`,
+        `Components  : ${selected.join(', ')}`,
+        `API URL     : ${apiUrl}`,
+        `InstallRoot : ${installRoot}`,
+    ]);
+    // 1) Detect versions (components + native updater when distributed).
+    log.step('[1/6] Detecting latest versions...');
+    const updaterSpec = resolveComponent('updater', platform); // win/linux/macOS (null only on unsupported RIDs)
+    let updaterInfo = null;
+    if (updaterSpec) {
+        updaterInfo = await getLatestVersionInfo(apiUrl, updaterSpec.fileType);
+        log.info(`Kyroon Updater v${updaterInfo.versionBuild}`);
+    }
+    const infos = new Map();
+    for (const spec of specs) {
+        const info = await getLatestVersionInfo(apiUrl, spec.fileType);
+        infos.set(spec.name, info);
+        log.info(`${spec.display} v${info.versionBuild}`);
+    }
+    // 2) Download everything (no running binary is touched yet).
+    log.step('[2/6] Downloading packages...');
+    let updaterArchive = null;
+    if (updaterSpec && updaterInfo) {
+        updaterArchive = await downloadAndVerify(updaterInfo, 'updater', downloadsDir);
+    }
+    const archives = new Map();
+    for (const spec of specs) {
+        archives.set(spec.name, await downloadAndVerify(infos.get(spec.name), spec.name, downloadsDir));
+    }
+    // 3) Stop running processes.
+    log.step('[3/6] Stopping running Kyroon processes...');
+    await stopKyroonProcesses(platform);
+    // 3.5) Ensure Python launcher for the Worker JSONL hooks.
+    if (selected.includes('worker')) {
+        await ensurePythonLauncher(platform).catch((err) => log.warn(`ensurePythonLauncher failed: ${err instanceof Error ? err.message : String(err)}`));
+    }
+    // 4) Install components (+ per-component native updater on win/linux/macOS).
+    log.step('[4/6] Installing components...');
+    const installed = [];
+    const binByComponent = new Map();
+    for (const spec of specs) {
+        const info = infos.get(spec.name);
+        const componentDir = path.join(installRoot, spec.name);
+        log.info(`${spec.display} -> ${componentDir}`);
+        await cleanComponentDir(componentDir);
+        await extractArchive(archives.get(spec.name), componentDir, {
+            strip: stripFor(spec.name, info.fileName, platform),
+        });
+        await fs.remove(archives.get(spec.name));
+        const binary = await locateBinary(componentDir, spec.binary);
+        if (!binary)
+            throw new Error(`${spec.binary} not found in ${componentDir} after extraction.`);
+        if (updaterSpec && updaterInfo && updaterArchive) {
+            await installUpdater(componentDir, updaterArchive, updaterInfo, updaterSpec);
+        }
+        await writeInstalledVersion(componentDir, spec, info, platform, apiUrl);
+        installed.push({ name: spec.name, dir: componentDir, binary, version: info.versionBuild });
+        binByComponent.set(spec.name, binary);
+    }
+    if (updaterArchive)
+        await fs.remove(updaterArchive);
+    // 5) Shortcuts.
+    log.step('[5/6] Creating shortcuts...');
+    if (wantService) {
+        const targets = [];
+        for (const c of ['app', 'worker']) {
+            const binary = binByComponent.get(c);
+            if (binary)
+                targets.push({ component: c, binary });
+        }
+        await createShortcuts(platform, targets, { startup: true });
+    }
+    else {
+        log.info('Shortcuts skipped (--no-service).');
+    }
+    // 6) Activation + start.
+    log.step('[6/6] Activation and startup...');
+    await activateAndStart(platform, binByComponent, {
+        activationCode: options.activationCode,
+        service: wantService,
+        start: wantStart,
+    });
+    log.banner('Kyroon Enterprise installed!', [
+        `Install root : ${installRoot}`,
+        ...installed.map((c) => `${c.name} : ${c.dir}`),
+    ]);
+    return { installRoot, components: installed };
+}
+function dedupeComponents(components) {
+    const out = [];
+    for (const c of components) {
+        if (c === 'updater')
+            continue; // updater is installed implicitly per component
+        if (!out.includes(c))
+            out.push(c);
+    }
+    if (out.length === 0)
+        throw new Error('No components selected to install.');
+    return out;
+}
+function requireSpec(name, platform) {
+    const spec = resolveComponent(name, platform);
+    if (!spec) {
+        throw new Error(`Component '${name}' is not distributed for ${platform.slug}.`);
+    }
+    return spec;
+}
+/** `tar --strip-components` analog: 1 for wrapped tarballs, 0 for macOS bundles/zip. */
+function stripFor(name, fileName, platform) {
+    if (!isTarball(fileName))
+        return 0;
+    if (platform.os === 'osx' && (name === 'app' || name === 'terminal'))
+        return 0;
+    return 1;
+}
+/** Wipes a component dir but preserves `updater/` and `installed-version.json`. */
+async function cleanComponentDir(dir) {
+    if (!(await fs.pathExists(dir))) {
+        await fs.ensureDir(dir);
+        return;
+    }
+    for (const entry of await fs.readdir(dir)) {
+        if (entry === 'updater' || entry === 'installed-version.json')
+            continue;
+        await fs.remove(path.join(dir, entry));
+    }
+}
+/** Installs a fresh copy of the native updater under `<componentDir>/updater`. */
+async function installUpdater(componentDir, updaterArchive, updaterInfo, updaterSpec) {
+    const updaterDir = path.join(componentDir, 'updater');
+    await fs.remove(updaterDir);
+    await fs.ensureDir(updaterDir);
+    await extractArchive(updaterArchive, updaterDir, { strip: isTarball(updaterInfo.fileName) ? 1 : 0 });
+    const bin = await locateBinary(updaterDir, updaterSpec.binary);
+    if (!bin) {
+        log.warn(`${updaterSpec.binary} not found in updater package.`);
+    }
+    // Sentinel read by the server-side re-provisioning skip (mirrors install.ps1).
+    await writeJsonAtomic(path.join(updaterDir, '.updater-version.json'), {
+        fileType: updaterSpec.fileType,
+        sha256: updaterInfo.sha256.toLowerCase(),
+        versionBuild: updaterInfo.versionBuild,
+        installedAt: new Date().toISOString(),
+    });
+}
+async function activateAndStart(platform, binByComponent, opts) {
+    const { execa } = await import('execa');
+    const workerBin = binByComponent.get('worker');
+    if (opts.activationCode) {
+        if (workerBin) {
+            log.info(`Activating Worker with code: ${opts.activationCode}`);
+            await execa(workerBin, ['activate', opts.activationCode], { reject: false });
+        }
+        else {
+            log.warn('--activation-code requires the worker component; ignored.');
+        }
+    }
+    if (!opts.service || !opts.start) {
+        log.info('Startup skipped.');
+        return;
+    }
+    if (workerBin) {
+        try {
+            execa(workerBin, [], { detached: true, stdio: 'ignore', cwd: path.dirname(workerBin) }).unref();
+        }
+        catch (err) {
+            log.warn(`Could not start Worker: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    const appBin = binByComponent.get('app');
+    if (appBin) {
+        try {
+            if (platform.os === 'osx') {
+                // The macOS app is a `.app` bundle (kyroon_app.app) and cannot be
+                // exec'd directly — launch it through `open`.
+                execa('open', [appBin], { detached: true, stdio: 'ignore' }).unref();
+            }
+            else {
+                execa(appBin, [], { detached: true, stdio: 'ignore', cwd: path.dirname(appBin) }).unref();
+            }
+        }
+        catch (err) {
+            log.warn(`Could not start App: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

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

package/dist/installGl.d.ts

@@ -0,0 +1,34 @@
+export interface RagLocalOptions {
+    /** Local mode identity (required to bring the stack up in local mode). */
+    apiKey?: string;
+    workspaceId?: string;
+    localAgentId?: string;
+    mode?: 'local' | 'proxy';
+    grpcPort?: number;
+    ollamaPort?: number;
+    qdrantHttpPort?: number;
+    qdrantGrpcPort?: number;
+    chatModel?: string;
+    embedModel?: string;
+    image?: string;
+    gpu?: boolean;
+    /** Skip pulling Ollama models after the stack is up. */
+    skipModels?: boolean;
+    installDir?: string;
+    qdrantApiKey?: string;
+    cloudGrpcUrl?: string;
+    uninstall?: boolean;
+    /** Extra raw KEY=VALUE env pairs (LLM provider keys, model overrides, ...). */
+    extraEnv?: Record<string, string>;
+}
+/**
+ * Installs the Kyroon Local AI Gateway (gRPC-local + Ollama + Qdrant) via Docker
+ * Compose. Self-contained: it generates `.env` + `docker-compose.deploy.yml` in
+ * the working dir and runs `docker compose up -d`. Mirrors the docker target of
+ * `install-gl.ps1` / `install-gl.sh`.
+ *
+ * The native Windows-Service / systemd targets are NOT exposed via npm (they
+ * need the .NET source tree); use the official `install-gl` script for those.
+ */
+export declare function installRagLocal(options: RagLocalOptions): Promise<void>;
+//# sourceMappingURL=installGl.d.ts.map

package/dist/installGl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installGl.d.ts","sourceRoot":"","sources":["../src/installGl.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,wDAAwD;IACxD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAiBD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA8C7E"}

package/dist/installGl.js

@@ -0,0 +1,235 @@
+import path from 'node:path';
+import { execa } from 'execa';
+import fs from 'fs-extra';
+import { defaultLocalAiDir } from './config.js';
+import { detectPlatform } from './platform.js';
+import * as log from './logger.js';
+const DEFAULTS = {
+    mode: 'local',
+    grpcPort: 18080,
+    ollamaPort: 11434,
+    qdrantHttpPort: 6333,
+    qdrantGrpcPort: 6334,
+    chatModel: 'gemma4:e2b',
+    embedModel: 'nomic-embed-text',
+    image: 'aikyroon/kyroon-grpc-local:latest',
+    gpu: true,
+    cloudGrpcUrl: 'https://grpc-proxy.kyroon.ai',
+};
+const COMPOSE_FILE = 'docker-compose.deploy.yml';
+/**
+ * Installs the Kyroon Local AI Gateway (gRPC-local + Ollama + Qdrant) via Docker
+ * Compose. Self-contained: it generates `.env` + `docker-compose.deploy.yml` in
+ * the working dir and runs `docker compose up -d`. Mirrors the docker target of
+ * `install-gl.ps1` / `install-gl.sh`.
+ *
+ * The native Windows-Service / systemd targets are NOT exposed via npm (they
+ * need the .NET source tree); use the official `install-gl` script for those.
+ */
+export async function installRagLocal(options) {
+    const platform = detectPlatform();
+    const mode = options.mode ?? DEFAULTS.mode;
+    const workDir = options.installDir ?? defaultLocalAiDir(platform);
+    const gpu = options.gpu ?? DEFAULTS.gpu;
+    await assertDocker();
+    if (options.uninstall) {
+        log.banner('Kyroon Local AI Gateway — uninstall');
+        if (await fs.pathExists(path.join(workDir, COMPOSE_FILE))) {
+            await runCompose(workDir, ['-f', COMPOSE_FILE, 'down']);
+        }
+        else {
+            log.warn(`No ${COMPOSE_FILE} found in ${workDir}; nothing to bring down.`);
+        }
+        log.success('Stack removed. Named volumes preserved (docker volume ls | grep kyroon).');
+        return;
+    }
+    if (mode === 'local' && (!options.apiKey || !options.workspaceId)) {
+        throw new Error('--api-key and --workspace-id are required in local mode.');
+    }
+    await fs.ensureDir(workDir);
+    await fs.writeFile(path.join(workDir, COMPOSE_FILE), composeContent(gpu), 'utf8');
+    await fs.writeFile(path.join(workDir, '.env'), envContent(options, mode), 'utf8');
+    log.banner('Kyroon Local AI Gateway Installer', [
+        `Mode     : ${mode}`,
+        `GPU      : ${gpu}`,
+        `WorkDir  : ${workDir}`,
+        `gRPC port: ${options.grpcPort ?? DEFAULTS.grpcPort}`,
+    ]);
+    log.step(`Bringing up ${COMPOSE_FILE}...`);
+    await runCompose(workDir, ['-f', COMPOSE_FILE, 'up', '-d', '--remove-orphans']);
+    if (!options.skipModels && mode === 'local') {
+        await pullModels(workDir, options);
+    }
+    log.banner('Kyroon Local AI Gateway is up!', [
+        `docker compose -f ${path.join(workDir, COMPOSE_FILE)} ps`,
+        `docker compose -f ${path.join(workDir, COMPOSE_FILE)} logs -f`,
+        `curl http://127.0.0.1:${options.grpcPort ?? DEFAULTS.grpcPort}/health/mode`,
+    ]);
+}
+async function assertDocker() {
+    try {
+        await execa('docker', ['--version']);
+    }
+    catch {
+        throw new Error('Docker not found. Install Docker Desktop / Docker Engine: https://www.docker.com/products/docker-desktop/');
+    }
+}
+async function runCompose(cwd, args) {
+    await execa('docker', ['compose', ...args], { cwd, stdio: 'inherit' });
+}
+async function pullModels(workDir, options) {
+    // `compose up -d` returns before Ollama passes its healthcheck; poll first.
+    log.step('Waiting for Ollama to become ready...');
+    const ready = await waitForOllama(workDir);
+    if (!ready) {
+        log.warn('Ollama did not respond in time; models NOT pulled. Pull them manually with `ollama pull`.');
+        return;
+    }
+    for (const model of [options.chatModel ?? DEFAULTS.chatModel, options.embedModel ?? DEFAULTS.embedModel]) {
+        if (!model)
+            continue;
+        log.info(`Pulling Ollama model ${model} ...`);
+        try {
+            await runCompose(workDir, ['-f', COMPOSE_FILE, 'exec', '-T', 'ollama', 'ollama', 'pull', model]);
+        }
+        catch {
+            log.warn(`Failed to pull ${model}. Run manually: docker compose exec ollama ollama pull ${model}`);
+        }
+    }
+}
+async function waitForOllama(workDir, retries = 30, delaySeconds = 5) {
+    for (let i = 0; i < retries; i++) {
+        const res = await execa('docker', ['compose', '-f', COMPOSE_FILE, 'exec', '-T', 'ollama', 'ollama', 'list'], {
+            cwd: workDir,
+            reject: false,
+        });
+        if (res.exitCode === 0)
+            return true;
+        await new Promise((r) => setTimeout(r, delaySeconds * 1000));
+    }
+    return false;
+}
+function envContent(options, mode) {
+    const lines = [
+        '# Generated by @aikyroon/rag-local — do not version.',
+        `MODE=${mode}`,
+        `KYROON_LOCAL_IMAGE=${options.image ?? DEFAULTS.image}`,
+        `KYROON_LOCAL_API_KEY=${options.apiKey ?? ''}`,
+        `KYROON_WORKSPACE_ID=${options.workspaceId ?? ''}`,
+        `KYROON_LOCAL_AGENT_ID=${options.localAgentId ?? ''}`,
+        `KYROON_LOCAL_GRPC_PORT=${options.grpcPort ?? DEFAULTS.grpcPort}`,
+        `RELAY_ENABLED=true`,
+        `KYROON_CLOUD_GRPC_URL=${options.cloudGrpcUrl ?? DEFAULTS.cloudGrpcUrl}`,
+        `OLLAMA_BASE_URL=http://ollama:11434`,
+        `OLLAMA_CHAT_MODEL=${options.chatModel ?? DEFAULTS.chatModel}`,
+        `OLLAMA_EMBEDDING_MODEL=${options.embedModel ?? DEFAULTS.embedModel}`,
+        `OLLAMA_PORT=${options.ollamaPort ?? DEFAULTS.ollamaPort}`,
+        `QDRANT_URL=http://qdrant:6333`,
+        `QDRANT_COLLECTION=kyroon_knowledge`,
+        `QDRANT_HTTP_PORT=${options.qdrantHttpPort ?? DEFAULTS.qdrantHttpPort}`,
+        `QDRANT_GRPC_PORT=${options.qdrantGrpcPort ?? DEFAULTS.qdrantGrpcPort}`,
+        `QDRANT_API_KEY=${options.qdrantApiKey ?? ''}`,
+    ];
+    for (const [key, value] of Object.entries(options.extraEnv ?? {})) {
+        lines.push(`${key}=${value}`);
+    }
+    return `${lines.join('\n')}\n`;
+}
+/** Embedded deploy compose — mirrors docker-compose.deploy.yml from install-gl. */
+function composeContent(gpu) {
+    const gpuLine = gpu ? '    gpus: all\n' : '';
+    return `name: kyroon-local-ai
+services:
+  kyroon-local-grpc:
+    container_name: kyroon-local-grpc
+    image: \${KYROON_LOCAL_IMAGE:-aikyroon/kyroon-grpc-local:latest}
+    pull_policy: always
+    restart: unless-stopped
+    environment:
+      MODE: \${MODE:-local}
+      ASPNETCORE_ENVIRONMENT: Production
+      ASPNETCORE_URLS: http://+:8080
+      Kestrel__EndpointDefaults__Protocols: Http2
+      LocalAi__ApiKey: \${KYROON_LOCAL_API_KEY:?KYROON_LOCAL_API_KEY required}
+      LocalAi__WorkspaceId: \${KYROON_WORKSPACE_ID:?KYROON_WORKSPACE_ID required}
+      LocalAi__LocalAgentId: \${KYROON_LOCAL_AGENT_ID:-}
+      LocalAi__AllowAnonymous: "false"
+      Ollama__BaseUrl: \${OLLAMA_BASE_URL:-http://ollama:11434}
+      Ollama__ChatModel: \${OLLAMA_CHAT_MODEL:-gemma4:e2b}
+      Ollama__EmbeddingModel: \${OLLAMA_EMBEDDING_MODEL:-nomic-embed-text}
+      LLM_CHAT_PROVIDER: \${LLM_CHAT_PROVIDER:-ollama}
+      LLM_EMBEDDING_PROVIDER: \${LLM_EMBEDDING_PROVIDER:-ollama}
+      OPENAI_API_KEY: \${OPENAI_API_KEY:-}
+      OPENAI_CHAT_MODEL: \${OPENAI_CHAT_MODEL:-}
+      OPENAI_EMBEDDING_MODEL: \${OPENAI_EMBEDDING_MODEL:-}
+      CLAUDE_API_KEY: \${CLAUDE_API_KEY:-}
+      CLAUDE_CHAT_MODEL: \${CLAUDE_CHAT_MODEL:-}
+      GEMINI_API_KEY: \${GEMINI_API_KEY:-}
+      GEMINI_CHAT_MODEL: \${GEMINI_CHAT_MODEL:-}
+      GEMINI_EMBEDDING_MODEL: \${GEMINI_EMBEDDING_MODEL:-}
+      Qdrant__Url: \${QDRANT_URL:-http://qdrant:6333}
+      Qdrant__ApiKey: \${QDRANT_API_KEY:-}
+      Qdrant__Collection: \${QDRANT_COLLECTION:-kyroon_knowledge}
+      CloudRelay__Enabled: \${RELAY_ENABLED:-true}
+      CloudRelay__CloudGrpcUrl: \${KYROON_CLOUD_GRPC_URL:-https://grpc-proxy.kyroon.ai}
+      CloudRelay__WorkspaceId: \${KYROON_WORKSPACE_ID:?KYROON_WORKSPACE_ID required}
+      CloudRelay__LocalAgentId: \${KYROON_LOCAL_AGENT_ID:-}
+    ports:
+      - "127.0.0.1:\${KYROON_LOCAL_GRPC_PORT:-18080}:8080"
+    volumes:
+      - local_config:/app/data
+    depends_on:
+      ollama:
+        condition: service_healthy
+      qdrant:
+        condition: service_healthy
+    networks:
+      - kyroon_local
+  ollama:
+    container_name: kyroon-ollama
+    image: ollama/ollama:latest
+    restart: unless-stopped
+${gpuLine}    environment:
+      OLLAMA_KEEP_ALIVE: \${OLLAMA_KEEP_ALIVE:-30m}
+    ports:
+      - "127.0.0.1:\${OLLAMA_PORT:-11434}:11434"
+    volumes:
+      - ollama_data:/root/.ollama
+    networks:
+      - kyroon_local
+    healthcheck:
+      test: ["CMD", "ollama", "list"]
+      interval: 10s
+      timeout: 5s
+      retries: 12
+      start_period: 30s
+  qdrant:
+    container_name: kyroon-qdrant
+    image: qdrant/qdrant:latest
+    restart: unless-stopped
+    environment:
+      QDRANT__SERVICE__HTTP_PORT: 6333
+      QDRANT__SERVICE__GRPC_PORT: 6334
+      QDRANT__SERVICE__API_KEY: \${QDRANT_API_KEY:-}
+    ports:
+      - "127.0.0.1:\${QDRANT_HTTP_PORT:-6333}:6333"
+      - "127.0.0.1:\${QDRANT_GRPC_PORT:-6334}:6334"
+    volumes:
+      - qdrant_data:/qdrant/storage
+    networks:
+      - kyroon_local
+    healthcheck:
+      test: ["CMD-SHELL", "bash -c ':> /dev/tcp/127.0.0.1/6333' || exit 1"]
+      interval: 10s
+      timeout: 5s
+      retries: 12
+      start_period: 15s
+volumes:
+  ollama_data: { name: kyroon_ollama_data }
+  qdrant_data: { name: kyroon_qdrant_data }
+  local_config: { name: kyroon_local_config }
+networks:
+  kyroon_local: { name: kyroon_local, driver: bridge }
+`;
+}
+//# sourceMappingURL=installGl.js.map

package/dist/installGl.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,7 @@
+export declare function banner(title: string, lines?: string[]): void;
+export declare function step(message: string): void;
+export declare function info(message: string): void;
+export declare function success(message: string): void;
+export declare function warn(message: string): void;
+export declare function error(message: string): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,EAAO,GAAG,IAAI,CAMhE;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3C"}

package/dist/logger.js

@@ -0,0 +1,25 @@
+import chalk from 'chalk';
+export function banner(title, lines = []) {
+    const bar = '='.repeat(60);
+    console.log(chalk.cyan(bar));
+    console.log(chalk.cyan(` ${title}`));
+    for (const line of lines)
+        console.log(chalk.cyan(`   ${line}`));
+    console.log(chalk.cyan(bar));
+}
+export function step(message) {
+    console.log(chalk.bold(message));
+}
+export function info(message) {
+    console.log(`   ${message}`);
+}
+export function success(message) {
+    console.log(chalk.green(`✔ ${message}`));
+}
+export function warn(message) {
+    console.warn(chalk.yellow(`[WARN] ${message}`));
+}
+export function error(message) {
+    console.error(chalk.red(`[ERROR] ${message}`));
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,UAAU,MAAM,CAAC,KAAa,EAAE,QAAkB,EAAE;IACxD,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;IAChE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,GAAG,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,OAAe;IACnC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,OAAO,EAAE,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,11 @@
+import type { ComponentSpec, InstalledVersionManifest, PlatformInfo, VersionInfo } from './types.js';
+/** Atomically writes JSON via a temp file + rename. */
+export declare function writeJsonAtomic(filePath: string, value: unknown): Promise<void>;
+/**
+ * Writes `<componentDir>/installed-version.json` — the source of truth read by
+ * the native updater / UpdateChecker to decide whether an update is available
+ * (it compares `sha256`). Mirrors `Write-InstalledVersion` (install.ps1).
+ */
+export declare function writeInstalledVersion(componentDir: string, spec: ComponentSpec, info: VersionInfo, platform: PlatformInfo, apiUrl: string): Promise<void>;
+export declare function readInstalledVersion(componentDir: string): Promise<InstalledVersionManifest | null>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,wBAAwB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAErG,uDAAuD;AACvD,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAIrF;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAQ1C"}

package/dist/manifest.js

@@ -0,0 +1,38 @@
+import path from 'node:path';
+import fs from 'fs-extra';
+/** Atomically writes JSON via a temp file + rename. */
+export async function writeJsonAtomic(filePath, value) {
+    const tmp = `${filePath}.tmp`;
+    await fs.writeFile(tmp, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
+    await fs.move(tmp, filePath, { overwrite: true });
+}
+/**
+ * Writes `<componentDir>/installed-version.json` — the source of truth read by
+ * the native updater / UpdateChecker to decide whether an update is available
+ * (it compares `sha256`). Mirrors `Write-InstalledVersion` (install.ps1).
+ */
+export async function writeInstalledVersion(componentDir, spec, info, platform, apiUrl) {
+    const payload = {
+        fileType: spec.fileType,
+        platformSlug: platform.slug,
+        versionBuild: info.versionBuild,
+        sha256: info.sha256.toLowerCase(),
+        installedAt: new Date().toISOString(),
+        installDir: componentDir,
+        binaryName: spec.binary,
+        apiUrl,
+    };
+    await writeJsonAtomic(path.join(componentDir, 'installed-version.json'), payload);
+}
+export async function readInstalledVersion(componentDir) {
+    const file = path.join(componentDir, 'installed-version.json');
+    if (!(await fs.pathExists(file)))
+        return null;
+    try {
+        return (await fs.readJson(file));
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,UAAU,CAAC;AAG1B,uDAAuD;AACvD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB,EAAE,KAAc;IACpE,MAAM,GAAG,GAAG,GAAG,QAAQ,MAAM,CAAC;IAC9B,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACvE,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,YAAoB,EACpB,IAAmB,EACnB,IAAiB,EACjB,QAAsB,EACtB,MAAc;IAEd,MAAM,OAAO,GAA6B;QACxC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,YAAY,EAAE,QAAQ,CAAC,IAAI;QAC3B,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE;QACjC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,UAAU,EAAE,YAAY;QACxB,UAAU,EAAE,IAAI,CAAC,MAAM;QACvB,MAAM;KACP,CAAC;IACF,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,wBAAwB,CAAC,EAAE,OAAO,CAAC,CAAC;AACpF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,YAAoB;IAEpB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,wBAAwB,CAAC,CAAC;IAC/D,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAA6B,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/platform.d.ts

@@ -0,0 +1,11 @@
+import type { ComponentName, ComponentSpec, OsName, PlatformInfo } from './types.js';
+export declare function detectPlatform(): PlatformInfo;
+/** Expected binary/bundle name for a component on a given OS. */
+export declare function binaryName(name: ComponentName, osName: OsName): string;
+/**
+ * Resolve a component for the current platform.
+ * Returns `null` when the component is not distributed for this platform
+ * (e.g. an unsupported RID such as win-arm64 before it is published).
+ */
+export declare function resolveComponent(name: ComponentName, platform: PlatformInfo): ComponentSpec | null;
+//# sourceMappingURL=platform.d.ts.map

package/dist/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAY,aAAa,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAgC/F,wBAAgB,cAAc,IAAI,YAAY,CAgB7C;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAetE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,GAAG,aAAa,GAAG,IAAI,CAIlG"}