@aikyroon/installer-core 1.0.0

package/README.md

@@ -0,0 +1,28 @@
+# @aikyroon/installer-core
+
+Shared bootstrap logic for the Kyroon Enterprise NPM installers
+(`@aikyroon/installer`, `@aikyroon/worker`, `@aikyroon/app`, `@aikyroon/rag-local`).
+
+It exposes:
+
+- `runCli(preset)` — the Commander-based CLI used by every thin package.
+- `installComponents(opts)` — detect → download(+SHA256) → extract → updater → shortcuts.
+- `uninstallComponents(opts)`, `doctor(opts)`, `installRagLocal(opts)`.
+- Low-level helpers: `getLatestVersionInfo`, `downloadAndVerify`, `extractArchive`,
+  `detectPlatform`, `resolveComponent`, …
+
+Mirrors the `install.ps1` / `install.sh` / `install-gl.*` scripts of the Kyroon
+Enterprise server, re-implemented in TypeScript for NPM distribution.
+
+```ts
+import { runCli } from '@aikyroon/installer-core';
+
+runCli({
+  bin: 'kyroon',
+  productName: 'Kyroon Enterprise',
+  cliVersion: '1.0.0',
+  description: 'Installs the Kyroon Enterprise environment.',
+  kind: 'components',
+  components: ['worker', 'terminal', 'app'],
+});
+```

package/dist/api.d.ts

@@ -0,0 +1,10 @@
+import type { VersionInfo } from './types.js';
+/**
+ * Queries the Kyroon Version API for the latest build of a FileType.
+ * Mirrors `Get-LatestVersionInfo` (install.ps1) /
+ * `GET {apiUrl}/api/Version/latest/info?fileType=N` (install.sh).
+ *
+ * The API answers camelCase JSON: { pathUrl, sha256, fileName, versionBuild, ... }.
+ */
+export declare function getLatestVersionInfo(apiUrl: string, fileType: number): Promise<VersionInfo>;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAsBjG"}

package/dist/api.js

@@ -0,0 +1,32 @@
+import axios from 'axios';
+import { normalizeApiUrl } from './config.js';
+/**
+ * Queries the Kyroon Version API for the latest build of a FileType.
+ * Mirrors `Get-LatestVersionInfo` (install.ps1) /
+ * `GET {apiUrl}/api/Version/latest/info?fileType=N` (install.sh).
+ *
+ * The API answers camelCase JSON: { pathUrl, sha256, fileName, versionBuild, ... }.
+ */
+export async function getLatestVersionInfo(apiUrl, fileType) {
+    const url = `${normalizeApiUrl(apiUrl)}/api/Version/latest/info?fileType=${fileType}`;
+    let data;
+    try {
+        const res = await axios.get(url, { timeout: 30_000, headers: { Accept: 'application/json' } });
+        data = res.data;
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to query version info (fileType=${fileType}) at ${url}: ${reason}`);
+    }
+    const info = data;
+    if (!info || !info.pathUrl || !info.sha256 || !info.fileName || info.versionBuild == null) {
+        throw new Error(`Invalid API response for fileType=${fileType}: ${JSON.stringify(data)}`);
+    }
+    return {
+        pathUrl: info.pathUrl,
+        sha256: info.sha256,
+        fileName: info.fileName,
+        versionBuild: String(info.versionBuild),
+    };
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAAc,EAAE,QAAgB;IACzE,MAAM,GAAG,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,qCAAqC,QAAQ,EAAE,CAAC;IACtF,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;QAC/F,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,0CAA0C,QAAQ,QAAQ,GAAG,KAAK,MAAM,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,MAAM,IAAI,GAAG,IAAmC,CAAC;IACjD,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,EAAE,CAAC;QAC1F,MAAM,IAAI,KAAK,CAAC,qCAAqC,QAAQ,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC;KACxC,CAAC;AACJ,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,14 @@
+import type { ComponentName } from './types.js';
+export interface CliPreset {
+    /** Binary/command name (e.g. `kyroon`, `kyroon-worker`). */
+    bin: string;
+    productName: string;
+    cliVersion: string;
+    description: string;
+    kind: 'components' | 'rag-local';
+    /** Components managed by this CLI (for `kind: 'components'`). */
+    components?: ComponentName[];
+}
+/** Entry point used by every thin package's bin. */
+export declare function runCli(preset: CliPreset): void;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,SAAS;IACxB,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,YAAY,GAAG,WAAW,CAAC;IACjC,iEAAiE;IACjE,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;CAC9B;AAID,oDAAoD;AACpD,wBAAgB,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAW9C"}

package/dist/cli.js

@@ -0,0 +1,163 @@
+import { Command, Option } from 'commander';
+import { installComponents } from './install.js';
+import { uninstallComponents } from './uninstall.js';
+import { doctor } from './doctor.js';
+import { installRagLocal } from './installGl.js';
+import * as log from './logger.js';
+const VALID_COMPONENTS = ['worker', 'terminal', 'app'];
+/** Entry point used by every thin package's bin. */
+export function runCli(preset) {
+    const program = new Command();
+    program.name(preset.bin).description(preset.description).version(preset.cliVersion, '-v, --version');
+    if (preset.kind === 'components')
+        buildComponentCommands(program, preset);
+    else
+        buildRagLocalCommands(program, preset);
+    program.parseAsync(process.argv).catch((err) => {
+        log.error(err instanceof Error ? err.message : String(err));
+        process.exitCode = 1;
+    });
+}
+// ---------------------------------------------------------------------------
+// kind: 'components'  (installer / worker / app)
+// ---------------------------------------------------------------------------
+function buildComponentCommands(program, preset) {
+    const defaults = preset.components ?? VALID_COMPONENTS;
+    const addInstallOptions = (cmd) => cmd
+        .option('-c, --components <list>', `comma list override (${VALID_COMPONENTS.join(', ')}, all)`)
+        .option('--api-url <url>', 'Kyroon API URL (default: $KYROON_API_URL or https://api.kyroon.ai)')
+        .option('--install-root <dir>', 'installation root (default: $KYROON_HOME or platform default)')
+        .option('--activation-code <code>', 'activate the Worker after install')
+        .option('--no-service', 'do not create shortcuts / startup entries')
+        .option('--no-start', 'do not launch components after install');
+    const runInstall = async (opts) => {
+        await installComponents({
+            components: resolveComponents(opts.components, defaults),
+            apiUrl: opts.apiUrl,
+            installRoot: opts.installRoot,
+            activationCode: opts.activationCode,
+            service: opts.service,
+            start: opts.start,
+        });
+    };
+    addInstallOptions(program.command('install', { isDefault: true }).description(`install ${preset.productName}`)).action(runInstall);
+    addInstallOptions(program.command('update').description('re-install with the latest versions')).action(runInstall);
+    addInstallOptions(program.command('repair').description('force a clean re-install')).action(runInstall);
+    program
+        .command('uninstall')
+        .description(`remove ${preset.productName}`)
+        .option('-c, --components <list>', 'comma list override')
+        .option('--install-root <dir>', 'installation root')
+        .option('--purge', 'remove the whole install root')
+        .action(async (opts) => {
+        await uninstallComponents({
+            components: opts.components ? resolveComponents(opts.components, defaults) : defaults,
+            installRoot: opts.installRoot,
+            purge: opts.purge,
+        });
+    });
+    program
+        .command('doctor')
+        .description('diagnose the environment and installed components')
+        .option('--api-url <url>', 'Kyroon API URL')
+        .option('--install-root <dir>', 'installation root')
+        .action(async (opts) => {
+        await doctor({ components: defaults, apiUrl: opts.apiUrl, installRoot: opts.installRoot });
+    });
+    program
+        .command('modules')
+        .description('list the components managed by this CLI')
+        .action(() => {
+        log.banner(`${preset.productName} — modules`, defaults.map((c) => `- ${c}`));
+    });
+}
+function resolveComponents(raw, fallback) {
+    if (!raw)
+        return fallback;
+    const out = [];
+    for (const token of raw.split(',')) {
+        const name = token.trim().toLowerCase();
+        if (!name)
+            continue;
+        if (name === 'all' || name === 'todos' || name === 'todas')
+            return [...VALID_COMPONENTS];
+        if (name === 'flutter' || name === 'kyroon_app') {
+            if (!out.includes('app'))
+                out.push('app');
+            continue;
+        }
+        if (!isValidComponent(name)) {
+            throw new Error(`Invalid component '${token}'. Valid: ${VALID_COMPONENTS.join(', ')}, all.`);
+        }
+        if (!out.includes(name))
+            out.push(name);
+    }
+    return out.length > 0 ? out : fallback;
+}
+function isValidComponent(name) {
+    return VALID_COMPONENTS.includes(name);
+}
+// ---------------------------------------------------------------------------
+// kind: 'rag-local'  (Local AI gateway)
+// ---------------------------------------------------------------------------
+function buildRagLocalCommands(program, preset) {
+    program
+        .command('install', { isDefault: true })
+        .description(`install ${preset.productName} (Docker: gRPC-local + Ollama + Qdrant)`)
+        .requiredOption('--api-key <key>', 'Local AI gateway API key (local mode)')
+        .requiredOption('--workspace-id <uuid>', 'workspace id (local mode)')
+        .option('--local-agent-id <uuid>', 'local agent id')
+        .addOption(new Option('--mode <mode>', 'gateway mode').choices(['local', 'proxy']).default('local'))
+        .option('--grpc-port <port>', 'gRPC port', toInt, 18080)
+        .option('--chat-model <model>', 'Ollama chat model', 'gemma4:e2b')
+        .option('--embed-model <model>', 'Ollama embedding model', 'nomic-embed-text')
+        .option('--image <ref>', 'gRPC-local image', 'aikyroon/kyroon-grpc-local:latest')
+        .option('--no-gpu', 'disable GPU passthrough for Ollama')
+        .option('--skip-models', 'do not pull Ollama models')
+        .option('--qdrant-api-key <key>', 'Qdrant API key')
+        .option('--install-dir <dir>', 'working dir for compose/.env')
+        .action(async (opts) => {
+        await installRagLocal({
+            apiKey: opts.apiKey,
+            workspaceId: opts.workspaceId,
+            localAgentId: opts.localAgentId,
+            mode: opts.mode,
+            grpcPort: opts.grpcPort,
+            chatModel: opts.chatModel,
+            embedModel: opts.embedModel,
+            image: opts.image,
+            gpu: opts.gpu,
+            skipModels: opts.skipModels,
+            qdrantApiKey: opts.qdrantApiKey,
+            installDir: opts.installDir,
+        });
+    });
+    program
+        .command('uninstall')
+        .description('bring the Local AI stack down (named volumes preserved)')
+        .option('--install-dir <dir>', 'working dir for compose/.env')
+        .action(async (opts) => {
+        await installRagLocal({ uninstall: true, installDir: opts.installDir });
+    });
+    program
+        .command('doctor')
+        .description('check Docker availability')
+        .action(async () => {
+        const { execa } = await import('execa');
+        try {
+            const res = await execa('docker', ['--version']);
+            log.success(res.stdout.trim());
+        }
+        catch {
+            log.error('Docker not found. Install Docker Desktop / Engine.');
+            process.exitCode = 1;
+        }
+    });
+}
+function toInt(value) {
+    const n = Number.parseInt(value, 10);
+    if (Number.isNaN(n))
+        throw new Error(`Invalid integer: ${value}`);
+    return n;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,15 @@
+import type { PlatformInfo } from './types.js';
+/** Default Kyroon API URL (overridable via `KYROON_API_URL` or `--api-url`). */
+export declare function defaultApiUrl(): string;
+/**
+ * Default install root.
+ *   Windows -> C:\Kyroon              (or %KYROON_HOME%)
+ *   Linux   -> ~/.kyroon              (or $KYROON_HOME)
+ *   macOS   -> ~/.kyroon              (or $KYROON_HOME)
+ */
+export declare function defaultInstallRoot(platform: PlatformInfo): string;
+/** Default working dir for the Local AI gateway (rag-local). */
+export declare function defaultLocalAiDir(platform: PlatformInfo): string;
+export declare function stripTrailingSep(p: string): string;
+export declare function normalizeApiUrl(url: string): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,gFAAgF;AAChF,wBAAgB,aAAa,IAAI,MAAM,CAGtC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAKjE;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAMhE;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/config.js

@@ -0,0 +1,36 @@
+import os from 'node:os';
+import path from 'node:path';
+/** Default Kyroon API URL (overridable via `KYROON_API_URL` or `--api-url`). */
+export function defaultApiUrl() {
+    const env = process.env.KYROON_API_URL?.trim();
+    return env && env.length > 0 ? env : 'https://api.kyroon.ai';
+}
+/**
+ * Default install root.
+ *   Windows -> C:\Kyroon              (or %KYROON_HOME%)
+ *   Linux   -> ~/.kyroon              (or $KYROON_HOME)
+ *   macOS   -> ~/.kyroon              (or $KYROON_HOME)
+ */
+export function defaultInstallRoot(platform) {
+    const env = process.env.KYROON_HOME?.trim();
+    if (env && env.length > 0)
+        return stripTrailingSep(env);
+    if (platform.os === 'win')
+        return 'C:\\Kyroon';
+    return path.join(os.homedir(), '.kyroon');
+}
+/** Default working dir for the Local AI gateway (rag-local). */
+export function defaultLocalAiDir(platform) {
+    if (platform.os === 'win') {
+        const local = process.env.LOCALAPPDATA || path.join(os.homedir(), 'AppData', 'Local');
+        return path.join(local, 'KyroonLocalAi');
+    }
+    return path.join(os.homedir(), '.kyroon', 'local-ai');
+}
+export function stripTrailingSep(p) {
+    return p.replace(/[\\/]+$/, '');
+}
+export function normalizeApiUrl(url) {
+    return url.replace(/\/+$/, '');
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,gFAAgF;AAChF,MAAM,UAAU,aAAa;IAC3B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC;IAC/C,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,uBAAuB,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAsB;IACvD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;IAC5C,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACxD,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK;QAAE,OAAO,YAAY,CAAC;IAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,iBAAiB,CAAC,QAAsB;IACtD,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QACtF,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,CAAS;IACxC,OAAO,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACjC,CAAC"}

package/dist/doctor.d.ts

@@ -0,0 +1,9 @@
+import type { ComponentName } from './types.js';
+export interface DoctorOptions {
+    components: ComponentName[];
+    apiUrl?: string;
+    installRoot?: string;
+}
+/** Prints a diagnostic report: platform, API reachability, installed manifests, python. */
+export declare function doctor(options: DoctorOptions): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,2FAA2F;AAC3F,wBAAsB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA+ClE"}

package/dist/doctor.js

@@ -0,0 +1,59 @@
+import path from 'node:path';
+import { execa } from 'execa';
+import fs from 'fs-extra';
+import { getLatestVersionInfo } from './api.js';
+import { defaultApiUrl, defaultInstallRoot, normalizeApiUrl, stripTrailingSep } from './config.js';
+import { readInstalledVersion } from './manifest.js';
+import { detectPlatform, resolveComponent } from './platform.js';
+import * as log from './logger.js';
+/** Prints a diagnostic report: platform, API reachability, installed manifests, python. */
+export async function doctor(options) {
+    const platform = detectPlatform();
+    const apiUrl = normalizeApiUrl(options.apiUrl ?? defaultApiUrl());
+    const installRoot = stripTrailingSep(options.installRoot ?? defaultInstallRoot(platform));
+    log.banner('Kyroon Doctor', [`Platform : ${platform.slug}`, `API URL  : ${apiUrl}`, `InstallRoot : ${installRoot}`]);
+    log.step('Version API reachability');
+    for (const name of options.components) {
+        const spec = resolveComponent(name, platform);
+        if (!spec) {
+            log.warn(`${name}: not distributed for ${platform.slug}`);
+            continue;
+        }
+        try {
+            const info = await getLatestVersionInfo(apiUrl, spec.fileType);
+            log.success(`${spec.display}: latest v${info.versionBuild} (fileType=${spec.fileType})`);
+        }
+        catch (err) {
+            log.error(`${spec.display}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    log.step('Installed components');
+    for (const name of options.components) {
+        const dir = path.join(installRoot, name);
+        if (!(await fs.pathExists(dir))) {
+            log.info(`${name}: not installed`);
+            continue;
+        }
+        const manifest = await readInstalledVersion(dir);
+        if (manifest) {
+            log.success(`${name}: installed v${manifest.versionBuild} (${dir})`);
+        }
+        else {
+            log.warn(`${name}: directory exists but installed-version.json missing (${dir})`);
+        }
+    }
+    log.step('Python launcher (Worker JSONL hooks)');
+    const pyCmd = platform.os === 'win' ? 'py' : 'python3';
+    const pyArgs = platform.os === 'win' ? ['-3', '--version'] : ['--version'];
+    try {
+        const res = await execa(pyCmd, pyArgs, { reject: false });
+        if (res.exitCode === 0)
+            log.success(`${pyCmd} OK: ${(res.stdout || res.stderr).trim()}`);
+        else
+            log.warn(`${pyCmd} not resolving — hooks may fail (NoHookActivityTimeout).`);
+    }
+    catch {
+        log.warn(`${pyCmd} not found — install Python 3 for the Worker JSONL hooks.`);
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

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

package/dist/download.d.ts

@@ -0,0 +1,9 @@
+import type { VersionInfo } from './types.js';
+/**
+ * Downloads an archive to `<dir>/<name>-<fileName>` and validates its SHA256
+ * against the expected hash. Mirrors `Invoke-Download` (install.ps1) — a
+ * mismatch deletes the partial file and throws.
+ */
+export declare function downloadAndVerify(info: VersionInfo, name: string, dir: string): Promise<string>;
+export declare function sha256File(file: string): Promise<string>;
+//# sourceMappingURL=download.d.ts.map

package/dist/download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../src/download.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBrG;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQxD"}

package/dist/download.js

@@ -0,0 +1,40 @@
+import crypto from 'node:crypto';
+import path from 'node:path';
+import { pipeline } from 'node:stream/promises';
+import axios from 'axios';
+import fs from 'fs-extra';
+/**
+ * Downloads an archive to `<dir>/<name>-<fileName>` and validates its SHA256
+ * against the expected hash. Mirrors `Invoke-Download` (install.ps1) — a
+ * mismatch deletes the partial file and throws.
+ */
+export async function downloadAndVerify(info, name, dir) {
+    await fs.ensureDir(dir);
+    const safeName = path.basename(info.fileName);
+    const dest = path.join(dir, `${name}-${safeName}`);
+    await fs.remove(dest);
+    const response = await axios.get(info.pathUrl, {
+        responseType: 'stream',
+        timeout: 0,
+        maxContentLength: Infinity,
+        maxBodyLength: Infinity,
+    });
+    await pipeline(response.data, fs.createWriteStream(dest));
+    const actual = await sha256File(dest);
+    const expected = info.sha256.toLowerCase();
+    if (actual !== expected) {
+        await fs.remove(dest);
+        throw new Error(`${name} SHA256 mismatch! expected=${expected} actual=${actual}`);
+    }
+    return dest;
+}
+export function sha256File(file) {
+    return new Promise((resolve, reject) => {
+        const hash = crypto.createHash('sha256');
+        const stream = fs.createReadStream(file);
+        stream.on('data', (chunk) => hash.update(chunk));
+        stream.on('end', () => resolve(hash.digest('hex').toLowerCase()));
+        stream.on('error', reject);
+    });
+}
+//# sourceMappingURL=download.js.map

package/dist/download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../src/download.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,UAAU,CAAC;AAG1B;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAiB,EAAE,IAAY,EAAE,GAAW;IAClF,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,QAAQ,EAAE,CAAC,CAAC;IACnD,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAEtB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAW,IAAI,CAAC,OAAO,EAAE;QACvD,YAAY,EAAE,QAAQ;QACtB,OAAO,EAAE,CAAC;QACV,gBAAgB,EAAE,QAAQ;QAC1B,aAAa,EAAE,QAAQ;KACxB,CAAC,CAAC;IACH,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;IAE1D,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;IAC3C,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,8BAA8B,QAAQ,WAAW,MAAM,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACjD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QAClE,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/extract.d.ts

@@ -0,0 +1,16 @@
+export declare function isTarball(fileName: string): boolean;
+export declare function isZip(fileName: string): boolean;
+/**
+ * Extracts a `.zip` or `.tar.gz` archive into `dest`.
+ * `strip` mirrors `tar --strip-components` (used for tarballs that wrap the
+ * payload under a top-level folder, e.g. the worker/app/terminal packages).
+ */
+export declare function extractArchive(archivePath: string, dest: string, opts?: {
+    strip?: number;
+}): Promise<void>;
+/**
+ * Recursively locates an expected binary/bundle inside `dir`.
+ * Returns the absolute path or `null` if not found.
+ */
+export declare function locateBinary(dir: string, expected: string): Promise<string | null>;
+//# sourceMappingURL=extract.d.ts.map

package/dist/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../src/extract.ts"],"names":[],"mappings":"AAKA,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5B,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoBxF"}

package/dist/extract.js

@@ -0,0 +1,56 @@
+import path from 'node:path';
+import extractZip from 'extract-zip';
+import fs from 'fs-extra';
+import * as tar from 'tar';
+export function isTarball(fileName) {
+    return /\.(tar\.gz|tgz)$/i.test(fileName);
+}
+export function isZip(fileName) {
+    return /\.zip$/i.test(fileName);
+}
+/**
+ * Extracts a `.zip` or `.tar.gz` archive into `dest`.
+ * `strip` mirrors `tar --strip-components` (used for tarballs that wrap the
+ * payload under a top-level folder, e.g. the worker/app/terminal packages).
+ */
+export async function extractArchive(archivePath, dest, opts = {}) {
+    await fs.ensureDir(dest);
+    if (isZip(archivePath)) {
+        await extractZip(archivePath, { dir: path.resolve(dest) });
+        return;
+    }
+    if (isTarball(archivePath)) {
+        await tar.x({ file: archivePath, cwd: dest, strip: opts.strip ?? 0 });
+        return;
+    }
+    throw new Error(`Unsupported archive type: ${path.basename(archivePath)}`);
+}
+/**
+ * Recursively locates an expected binary/bundle inside `dir`.
+ * Returns the absolute path or `null` if not found.
+ */
+export async function locateBinary(dir, expected) {
+    const direct = path.join(dir, expected);
+    if (await fs.pathExists(direct))
+        return direct;
+    const stack = [dir];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        let entries;
+        try {
+            entries = await fs.readdir(current, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const full = path.join(current, entry.name);
+            if (entry.name === expected)
+                return full;
+            if (entry.isDirectory())
+                stack.push(full);
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=extract.js.map

package/dist/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../src/extract.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,KAAK,GAAG,MAAM,KAAK,CAAC;AAE3B,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,OAAO,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,QAAgB;IACpC,OAAO,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,WAAmB,EACnB,IAAY,EACZ,OAA2B,EAAE;IAE7B,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACzB,IAAI,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QACvB,MAAM,UAAU,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3D,OAAO;IACT,CAAC;IACD,IAAI,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;QAC3B,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC;QACtE,OAAO;IACT,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAW,EAAE,QAAgB;IAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACxC,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAE/C,MAAM,KAAK,GAAa,CAAC,GAAG,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;QAC7B,IAAI,OAAoB,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;YACzC,IAAI,KAAK,CAAC,WAAW,EAAE;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { runCli, type CliPreset } from './cli.js';
+export { installComponents, type InstallOptions, type InstallResult } from './install.js';
+export { uninstallComponents, type UninstallOptions } from './uninstall.js';
+export { doctor, type DoctorOptions } from './doctor.js';
+export { installRagLocal, type RagLocalOptions } from './installGl.js';
+export { getLatestVersionInfo } from './api.js';
+export { downloadAndVerify, sha256File } from './download.js';
+export { extractArchive, locateBinary } from './extract.js';
+export { detectPlatform, resolveComponent, binaryName } from './platform.js';
+export { defaultApiUrl, defaultInstallRoot, defaultLocalAiDir, normalizeApiUrl, } from './config.js';
+export type { ComponentName, ComponentSpec, PlatformInfo, VersionInfo, InstalledVersionManifest, OsName, ArchName, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,aAAa,EACb,aAAa,EACb,YAAY,EACZ,WAAW,EACX,wBAAwB,EACxB,MAAM,EACN,QAAQ,GACT,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export { runCli } from './cli.js';
+export { installComponents } from './install.js';
+export { uninstallComponents } from './uninstall.js';
+export { doctor } from './doctor.js';
+export { installRagLocal } from './installGl.js';
+export { getLatestVersionInfo } from './api.js';
+export { downloadAndVerify, sha256File } from './download.js';
+export { extractArchive, locateBinary } from './extract.js';
+export { detectPlatform, resolveComponent, binaryName } from './platform.js';
+export { defaultApiUrl, defaultInstallRoot, defaultLocalAiDir, normalizeApiUrl, } from './config.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAkB,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAA2C,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAyB,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAsB,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,eAAe,EAAwB,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,GAChB,MAAM,aAAa,CAAC"}

package/dist/install.d.ts

@@ -0,0 +1,28 @@
+import type { ComponentName } from './types.js';
+export interface InstallOptions {
+    components: ComponentName[];
+    apiUrl?: string;
+    installRoot?: string;
+    activationCode?: string;
+    /** When false, skip shortcuts/auto-start (CI / headless). */
+    service?: boolean;
+    /** When false, do not launch components after install. */
+    start?: boolean;
+}
+export interface InstallResult {
+    installRoot: string;
+    components: {
+        name: ComponentName;
+        dir: string;
+        binary: string;
+        version: string;
+    }[];
+}
+/**
+ * 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 declare function installComponents(options: InstallOptions): Promise<InstallResult>;
+//# sourceMappingURL=install.d.ts.map