@knowzai/cli 0.4.0 → 0.5.1

package/dist/lib/runtime-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-operations.d.ts","sourceRoot":"","sources":["../../src/lib/runtime-operations.ts"],"names":[],"mappings":"AAIA,OAAO,EAQL,KAAK,eAAe,EACpB,KAAK,WAAW,EAEjB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EACL,oBAAoB,EAGrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACxB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAwB,KAAK,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAC1F,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AACD,MAAM,WAAW,oBAAqB,SAAQ,wBAAwB;IACpE,MAAM,CAAC,EAAE,aAAa,GAAG,kBAAkB,CAAC;IAC5C,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,mGAAmG;IACnG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IACnD,aAAa,CAAC,EAAE,OAAO,aAAa,CAAC;IACrC,eAAe,CAAC,EAAE,OAAO,oBAAoB,CAAC;IAC9C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,WAAW,CAAC;IAC/B,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;IAC3C,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;CAClD;AAyDD,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,qBAAqB,EAC5B,IAAI,GAAE,oBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoJhC"}

package/dist/lib/runtime-operations.js

@@ -0,0 +1,182 @@
+import { acquireRuntimeLock } from './runtime-lock.js';
+import { assertLocalEngineContext } from './local-engine-context.js';
+import { existsSync, readFileSync, rmSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { canonicalEndpoint, loadConfig, saveConfig, openCredentialStore, DEFAULT_PROFILE, KnowzError, ExitCode, } from '@knowzai/core';
+import { discoverRuntime } from './runtime-discovery.js';
+import { applyPlatform } from './platform-lifecycle.js';
+import { applySelfHostedAsync, resolvePackagedSelfHostedAssetsDir, resolveSelfHostedReleaseContract, } from './selfhosted-lifecycle.js';
+import { resolveEngineStatus, runEngineProbesAsync, } from './container-engine.js';
+import { nodeAsyncProcessRunner, parseEnv, planComposeInvocations, redactPlatformSecrets, } from './platform-runtime.js';
+import { parseComposeStatus } from './compose-status.js';
+import { runtimeHealth } from './runtime-status.js';
+import { probeRuntimeProvider } from './runtime-provider.js';
+export { parseComposeStatus } from './compose-status.js';
+function fail(message, code, exitCode = ExitCode.Usage) {
+    throw Object.assign(new KnowzError(message, exitCode), { code });
+}
+async function targetEngine(runtime, deps) {
+    const runner = deps.runner ?? nodeAsyncProcessRunner;
+    const env = deps.env ?? process.env;
+    const engine = deps.engine ?? resolveEngineStatus(await runEngineProbesAsync(runner), process.platform, env);
+    return assertLocalEngineContext(engine, {
+        runner,
+        env,
+        contextHost: deps.contextHost,
+        savedEngine: runtime.engine,
+        cwd: runtime.paths.runtimeDir,
+    });
+}
+async function purgeProfile(runtime, input, deps) {
+    if (!input.purgeProfile)
+        return false;
+    // Core credential stores resolve their config root per operation. Keep the override scoped to this explicit purge.
+    const before = process.env.KNOWZ_CONFIG_DIR;
+    if (input.configDir)
+        process.env.KNOWZ_CONFIG_DIR = resolve(input.configDir);
+    try {
+        const cfg = (deps.loadConfig ?? loadConfig)();
+        const profileName = runtime.state.name === 'knowz' ? 'local' : `local-${runtime.state.name}`;
+        const profile = cfg.profiles[profileName];
+        if (!profile ||
+            (profile.apiDialect &&
+                profile.apiDialect !== (runtime.edition === 'selfhosted' ? 'selfhosted' : 'platform')))
+            return false;
+        const expected = canonicalEndpoint(runtime.state.serviceUrls.api);
+        if (canonicalEndpoint(profile.apiUrl) !== expected ||
+            (profile.credentialApiUrl && canonicalEndpoint(profile.credentialApiUrl) !== expected))
+            return false;
+        const store = await (deps.credentialStore ?? openCredentialStore)();
+        await store.deleteSecret(profileName);
+        delete cfg.profiles[profileName];
+        if (cfg.activeProfile === profileName)
+            cfg.activeProfile = Object.keys(cfg.profiles)[0] ?? DEFAULT_PROFILE;
+        (deps.saveConfig ?? saveConfig)(cfg);
+        return true;
+    }
+    finally {
+        if (before === undefined)
+            delete process.env.KNOWZ_CONFIG_DIR;
+        else
+            process.env.KNOWZ_CONFIG_DIR = before;
+    }
+}
+export async function runRuntimeOperation(action, input, deps = {}) {
+    let runtime;
+    try {
+        runtime = discoverRuntime(input);
+    }
+    catch (error) {
+        fail(error instanceof Error ? error.message : 'Invalid runtime state.', 'RUNTIME_SELECTION');
+    }
+    if (!runtime)
+        fail(`Runtime '${input.name}' is not installed. Run knowz up to create it, or select its name/config directory.`, 'RUNTIME_ABSENT');
+    if (action === 'destroy' && !input.confirmed)
+        fail('Destroy requires explicit confirmation with --yes.', 'RUNTIME_CONFIRMATION');
+    if (action === 'upgrade' && !input.version?.trim())
+        fail('Runtime upgrade requires --version X.Y.Z.', 'RUNTIME_VERSION');
+    if (!existsSync(runtime.paths.composeFile) || !existsSync(runtime.paths.envFile))
+        fail('Runtime Compose/environment files are missing. Restore the runtime configuration before managing it.', 'RUNTIME_ASSETS');
+    const release = action === 'down' || action === 'destroy'
+        ? acquireRuntimeLock(runtime.paths.runtimeDir)
+        : undefined;
+    try {
+        const environment = parseEnv(readFileSync(runtime.paths.envFile, 'utf8'));
+        const secrets = Object.entries(environment)
+            .filter(([key]) => /password|secret|key|token|credential|passphrase/i.test(key))
+            .map(([, value]) => value);
+        const engine = await targetEngine(runtime, deps);
+        const common = {
+            action,
+            name: input.name,
+            edition: runtime.edition,
+            installedVersion: runtime.state.version,
+            runtimeDir: runtime.paths.runtimeDir,
+            engine: engine.engine,
+        };
+        if (action === 'upgrade') {
+            if (runtime.edition === 'portable') {
+                const applied = await (deps.applyPortable ?? applyPlatform)({
+                    action: 'upgrade',
+                    name: input.name,
+                    configDir: input.configDir,
+                    version: input.version,
+                }, { runner: deps.runner, engine });
+                return {
+                    ...common,
+                    installedVersion: applied.state.version,
+                    upgraded: true,
+                    output: applied.output,
+                };
+            }
+            const assets = deps.selfHostedAssetsDir ?? resolvePackagedSelfHostedAssetsDir();
+            const catalog = readFileSync(join(assets, 'releases.json'), 'utf8');
+            const from = resolveSelfHostedReleaseContract(catalog, runtime.state.version);
+            const to = resolveSelfHostedReleaseContract(catalog, input.version);
+            if (from.runtime.database !== to.runtime.database)
+                fail('Changing the database runtime requires export/import into a different instance; an in-place upgrade cannot reinterpret existing volumes.', 'RUNTIME_DATABASE');
+            const applied = await (deps.applySelfHosted ?? applySelfHostedAsync)({ name: input.name, configDir: input.configDir, version: input.version }, { runner: deps.runner, engine, packagedAssetsDir: assets });
+            return {
+                ...common,
+                installedVersion: applied.state.version,
+                upgraded: true,
+                output: `Selfhosted ${applied.state.version} is running.`,
+            };
+        }
+        const project = runtime.edition === 'selfhosted' ? `knowz-selfhosted-${input.name}` : input.name;
+        const profiles = runtime.edition === 'portable'
+            ? [
+                ...(runtime.state.components?.mcp === false ? [] : ['mcp']),
+                ...(runtime.state.components?.publicSite ? ['public-site'] : []),
+            ]
+            : [];
+        const steps = planComposeInvocations(action, runtime.paths, project, {
+            engine,
+            profiles,
+            confirmed: input.confirmed,
+            tail: input.tail,
+        });
+        const outputs = [];
+        for (const step of steps) {
+            const result = await (deps.runner ?? nodeAsyncProcessRunner)(step.command, step.args, step.options);
+            if (result.status !== 0 || result.error)
+                fail(redactPlatformSecrets(`Runtime ${action} failed: ${result.stderr || result.stdout || result.error?.message || String(result.status)}`, secrets), 'RUNTIME_PROCESS', ExitCode.Api);
+            outputs.push(result.stdout ?? '');
+        }
+        if (action === 'destroy') {
+            rmSync(runtime.paths.runtimeDir, { recursive: true, force: true });
+            const profilePurged = await purgeProfile(runtime, input, deps);
+            return {
+                ...common,
+                destroyed: true,
+                volumesDeleted: true,
+                profilePurged,
+                output: `Destroyed ${runtime.edition} runtime '${input.name}'.`,
+            };
+        }
+        if (action === 'down')
+            return {
+                ...common,
+                stopped: true,
+                volumesPreserved: true,
+                output: `Stopped ${runtime.edition} runtime '${input.name}'; data volumes were preserved.`,
+            };
+        if (action === 'logs')
+            return { ...common, output: redactPlatformSecrets(outputs.join('\n'), secrets) };
+        const health = runtimeHealth(runtime, environment, parseComposeStatus(redactPlatformSecrets(outputs.at(-1) ?? '', secrets)));
+        const connectivity = action === 'doctor' && health.provider.mode !== 'offline'
+            ? await probeRuntimeProvider(runtime, environment, deps) : undefined;
+        if (connectivity)
+            health.checks.push(connectivity.check);
+        return {
+            ...common,
+            ...health,
+            ...(connectivity ? { provider: { ...health.provider, connectivity: connectivity.connectivity, authentication: connectivity.authentication, model: connectivity.model } } : {}),
+            output: `${runtime.edition} '${input.name}': ${health.status} (${runtime.state.version})\n${health.checks.map((check) => `${check.name}: ${check.ok ? 'OK' : 'ATTENTION'} — ${check.detail}`).join('\n')}`,
+        };
+    }
+    finally {
+        release?.();
+    }
+}
+//# sourceMappingURL=runtime-operations.js.map

package/dist/lib/runtime-operations.js.map

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

package/dist/lib/runtime-provider.d.ts

@@ -0,0 +1,17 @@
+import type { InstalledRuntime } from './runtime-discovery.js';
+export interface RuntimeProviderProbeDeps {
+    fetchFn?: typeof fetch;
+    providerTimeoutMs?: number;
+}
+/** Host-side transport only: never sends credentials, follows redirects or generates tokens. */
+export declare function probeRuntimeProvider(runtime: InstalledRuntime, env: Record<string, string>, deps?: RuntimeProviderProbeDeps): Promise<{
+    check: {
+        name: string;
+        ok: boolean;
+        detail: string;
+    };
+    connectivity: "unavailable" | "reachable";
+    authentication: "not-checked";
+    model: "not-checked";
+}>;
+//# sourceMappingURL=runtime-provider.d.ts.map

package/dist/lib/runtime-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-provider.d.ts","sourceRoot":"","sources":["../../src/lib/runtime-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,gGAAgG;AAChG,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,gBAAgB,EACzB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,IAAI,GAAE,wBAA6B;;;;;;;;;GA0CpC"}

package/dist/lib/runtime-provider.js

@@ -0,0 +1,52 @@
+import { hostReachableEndpoint } from './platform-provider-probe.js';
+/** Host-side transport only: never sends credentials, follows redirects or generates tokens. */
+export async function probeRuntimeProvider(runtime, env, deps = {}) {
+    const result = (ok, detail) => ({
+        check: { name: 'Provider connectivity', ok, detail },
+        connectivity: ok ? 'reachable' : 'unavailable',
+        authentication: 'not-checked',
+        model: 'not-checked',
+    });
+    const mode = runtime.state.provider;
+    let endpoint = mode === 'azure'
+        ? env.AZURE_OPENAI_ENDPOINT
+        : runtime.edition === 'selfhosted' ? env.OPENAI_COMPAT_ENDPOINT : env.OPENAICOMPAT__ENDPOINT;
+    if (mode === 'gcp') {
+        const region = env.VERTEX__REGION || 'us-central1';
+        if (!/^[a-z][a-z0-9-]{1,30}$/.test(region))
+            return result(false, 'Invalid provider region; repair the runtime configuration.');
+        endpoint = `https://${region}-aiplatform.googleapis.com`;
+    }
+    let url;
+    try {
+        url = new URL(hostReachableEndpoint(endpoint ?? ''));
+        if (!['http:', 'https:'].includes(url.protocol) || url.username || url.password || url.search || url.hash)
+            throw new Error('Invalid endpoint');
+    }
+    catch {
+        return result(false, 'Provider endpoint is missing or invalid; repair the runtime configuration.');
+    }
+    const controller = new AbortController();
+    const timeoutMs = Math.max(1, Math.min(10_000, deps.providerTimeoutMs ?? 5_000));
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await (deps.fetchFn ?? globalThis.fetch)(url.toString(), {
+            method: 'GET', redirect: 'manual', signal: controller.signal,
+            headers: { accept: 'application/json' },
+        });
+        const ok = response.status >= 200 && response.status < 500 && !(response.status >= 300 && response.status < 400);
+        return result(ok, ok
+            ? `Configured provider endpoint is reachable from this host (HTTP ${response.status}); authentication and model behavior are not verified. Application overrides and container connectivity require the application connection test.`
+            : `Configured provider endpoint returned HTTP ${response.status}; redirects are not followed and server failures require attention.`);
+    }
+    catch {
+        return result(false, controller.signal.aborted
+            ? 'Provider connectivity check timed out; verify the configured endpoint and network.'
+            : 'Configured provider endpoint could not be reached from this host; verify the endpoint and network.');
+    }
+    finally {
+        clearTimeout(timer);
+        controller.abort();
+    }
+}
+//# sourceMappingURL=runtime-provider.js.map

package/dist/lib/runtime-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-provider.js","sourceRoot":"","sources":["../../src/lib/runtime-provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAOrE,gGAAgG;AAChG,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAyB,EACzB,GAA2B,EAC3B,OAAiC,EAAE;IAEnC,MAAM,MAAM,GAAG,CAAC,EAAW,EAAE,MAAc,EAAE,EAAE,CAAC,CAAC;QAC/C,KAAK,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE,EAAE,EAAE,MAAM,EAAE;QACpD,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC,WAAoB,CAAC,CAAC,CAAC,aAAsB;QAChE,cAAc,EAAE,aAAsB;QACtC,KAAK,EAAE,aAAsB;KAC9B,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;IACpC,IAAI,QAAQ,GAAG,IAAI,KAAK,OAAO;QAC7B,CAAC,CAAC,GAAG,CAAC,qBAAqB;QAC3B,CAAC,CAAC,OAAO,CAAC,OAAO,KAAK,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,CAAC,GAAG,CAAC,sBAAsB,CAAC;IAC/F,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,GAAG,CAAC,cAAc,IAAI,aAAa,CAAC;QACnD,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC,KAAK,EAAE,4DAA4D,CAAC,CAAC;QAC/H,QAAQ,GAAG,WAAW,MAAM,4BAA4B,CAAC;IAC3D,CAAC;IACD,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,qBAAqB,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACjJ,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,MAAM,CAAC,KAAK,EAAE,4EAA4E,CAAC,CAAC;IAAC,CAAC;IAC/G,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,iBAAiB,IAAI,KAAK,CAAC,CAAC,CAAC;IACjF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAC9D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;YACxE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM;YAC5D,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;SACxC,CAAC,CAAC;QACH,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;QACjH,OAAO,MAAM,CAAC,EAAE,EAAE,EAAE;YAClB,CAAC,CAAC,kEAAkE,QAAQ,CAAC,MAAM,kJAAkJ;YACrO,CAAC,CAAC,8CAA8C,QAAQ,CAAC,MAAM,qEAAqE,CAAC,CAAC;IAC1I,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,OAAO;YAC5C,CAAC,CAAC,oFAAoF;YACtF,CAAC,CAAC,oGAAoG,CAAC,CAAC;IAC5G,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,UAAU,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/lib/runtime-status.d.ts

@@ -0,0 +1,24 @@
+import type { InstalledRuntime } from './runtime-discovery.js';
+import type { parseComposeStatus } from './compose-status.js';
+type Service = ReturnType<typeof parseComposeStatus>[number];
+export interface RuntimeCheck {
+    name: string;
+    ok: boolean;
+    detail: string;
+}
+export declare function runtimeHealth(runtime: InstalledRuntime, environment: Record<string, string>, rows: Service[]): {
+    provider: {
+        mode: "offline" | "azure" | "gcp" | "knowz-cloud" | "openai-compatible";
+        configured: boolean;
+        connectivity: "not-checked";
+        detail: string;
+    };
+    desiredVersion?: string | undefined;
+    versionSources: import("./platform-lifecycle.js").PlatformVersionSources;
+    versionConsistent: boolean;
+    status: string;
+    checks: RuntimeCheck[];
+    services: import("./compose-status.js").ComposeStatusRow[];
+};
+export {};
+//# sourceMappingURL=runtime-status.d.ts.map

package/dist/lib/runtime-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-status.d.ts","sourceRoot":"","sources":["../../src/lib/runtime-status.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAiCD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,gBAAgB,EACzB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,IAAI,EAAE,OAAO,EAAE;;;;;;;;;;;;;EAkFhB"}

package/dist/lib/runtime-status.js

@@ -0,0 +1,128 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { observePlatformVersions } from './platform-lifecycle.js';
+function requirements(runtime) {
+    if (runtime.edition === 'selfhosted')
+        return [
+            { id: 'db', health: true },
+            { id: 'api', health: true },
+            { id: 'web', health: false },
+            ...(runtime.state.components?.mcp === false ? [] : [{ id: 'mcp', health: true }]),
+            ...(runtime.state.version.startsWith('0.15.')
+                ? [{ id: 'lmstudio-bridge', health: true }]
+                : []),
+        ];
+    const document = JSON.parse(readFileSync(join(runtime.paths.runtimeDir, 'runtime-contract.json'), 'utf8'));
+    const result = (document.services ?? [])
+        .filter((service) => service.required ||
+        (service.profile === 'mcp' && runtime.state.components?.mcp !== false) ||
+        (service.profile === 'public-site' && runtime.state.components?.publicSite))
+        .filter((service) => service.id !== 'object-storage' || runtime.state.storage === 'minio')
+        .map((service) => ({
+        id: service.id === 'object-storage' ? 'minio' : service.id,
+        health: service.health !== 'compose-process',
+    }));
+    if (!result.length)
+        throw new Error('Runtime contract has no required services. Restore the installed runtime contract.');
+    return result;
+}
+export function runtimeHealth(runtime, environment, rows) {
+    const checks = requirements(runtime).map((requirement) => {
+        const instances = rows.filter((row) => row.Service === requirement.id);
+        const ok = instances.length > 0 &&
+            instances.every((row) => row.State?.toLowerCase() === 'running' &&
+                (!requirement.health || row.Health?.toLowerCase() === 'healthy'));
+        return {
+            name: `Service ${requirement.id}`,
+            ok,
+            detail: instances.length
+                ? instances.map((row) => `${row.State ?? 'unknown'} ${row.Health ?? ''}`.trim()).join(', ')
+                : 'missing',
+        };
+    });
+    const versions = observePlatformVersions(runtime.state, {
+        ...environment,
+        KNOWZ_VERSION: (runtime.edition === 'selfhosted'
+            ? environment.KNOWZ_SELFHOSTED_VERSION
+            : environment.KNOWZ_VERSION) ?? '',
+    }, rows);
+    checks.push({
+        name: 'Runtime versions',
+        ok: versions.versionConsistent,
+        detail: `Installed ${runtime.state.version}; environment ${versions.versionSources.environment ?? 'missing'}; running ${JSON.stringify(versions.versionSources.running)}`,
+    });
+    if (runtime.hasHealthyState === false ||
+        (runtime.attemptStatus && runtime.attemptStatus !== 'ready')) {
+        checks.push({
+            name: 'Last attempt',
+            ok: false,
+            detail: `Last runtime attempt: ${runtime.attemptStatus ?? 'incomplete'}; ${runtime.hasHealthyState === false ? 'no verified installation has been committed' : 'the prior installed release is preserved'}. Retry setup or inspect runtime logs.`,
+        });
+    }
+    const allStopped = rows.length > 0 && rows.every((row) => row.State?.toLowerCase() !== 'running');
+    const status = rows.length === 0
+        ? 'missing'
+        : allStopped
+            ? 'stopped'
+            : checks.every((check) => check.ok)
+                ? 'ready'
+                : 'partial';
+    const attemptPath = join(runtime.paths.runtimeDir, 'attempt.json');
+    let desiredVersion;
+    if (existsSync(attemptPath)) {
+        try {
+            const attempted = JSON.parse(readFileSync(attemptPath, 'utf8'));
+            if (typeof attempted.version === 'string' &&
+                /^\d+\.\d+\.\d+(?:[-+][\w.-]+)?$/.test(attempted.version))
+                desiredVersion = attempted.version;
+        }
+        catch {
+            checks.push({
+                name: 'Last attempt',
+                ok: false,
+                detail: 'Invalid attempt metadata; inspect the runtime directory.',
+            });
+        }
+    }
+    const provider = providerReadiness(runtime, environment);
+    checks.push({ name: 'Provider configuration', ok: provider.configured, detail: provider.detail });
+    return {
+        status,
+        checks,
+        services: rows,
+        ...versions,
+        ...(desiredVersion ? { desiredVersion } : {}),
+        provider,
+    };
+}
+function providerReadiness(runtime, env) {
+    const mode = runtime.state.provider;
+    const required = mode === 'offline'
+        ? []
+        : mode === 'azure'
+            ? [
+                'AZURE_OPENAI_ENDPOINT',
+                runtime.edition === 'selfhosted' ? 'AZURE_OPENAI_APIKEY' : 'AZURE_OPENAI_API_KEY',
+            ]
+            : mode === 'gcp'
+                ? ['VERTEX__PROJECT', 'GCLOUD_ADC_PATH']
+                : runtime.edition === 'selfhosted'
+                    ? [
+                        'OPENAI_COMPAT_ENDPOINT',
+                        'OPENAI_COMPAT_CHAT_MODEL',
+                        'OPENAI_COMPAT_EMBEDDING_MODEL',
+                    ]
+                    : ['OPENAICOMPAT__ENDPOINT', 'OPENAICOMPAT__CHATMODEL', 'OPENAICOMPAT__EMBEDDINGMODEL'];
+    const missing = required.filter((key) => !env[key]?.trim());
+    return {
+        mode,
+        configured: missing.length === 0,
+        connectivity: 'not-checked',
+        detail: mode === 'offline'
+            ? env.KNOWZ_AI_DISABLED === 'true' ? 'AI is explicitly disabled by the host; knowledge storage remains available.' : 'No host AI provider is selected. Application configuration may override this; check Instance configuration for the active provider.'
+            : missing.length
+                ? `Missing provider settings: ${missing.join(', ')}. Reconfigure through knowz up.`
+                : 'Provider settings are present. Use the application connection test to verify provider connectivity.',
+    };
+}
+//# sourceMappingURL=runtime-status.js.map

package/dist/lib/runtime-status.js.map

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

package/dist/lib/selfhosted-backup.d.ts

@@ -0,0 +1,37 @@
+import { type PlatformPaths, type ProcessRunner, type AsyncProcessRunner } from './platform-runtime.js';
+import type { EngineStatus } from './container-engine.js';
+interface RuntimeInput {
+    paths: PlatformPaths;
+    projectName: string;
+    engine?: EngineStatus;
+    runner: ProcessRunner | AsyncProcessRunner;
+    emit?: (line: string) => void;
+}
+export declare function runSelfHostedBackup(input: RuntimeInput & {
+    out?: string;
+    encrypt: boolean;
+    passphrase?: string;
+    cliVersion: string;
+}): Promise<{
+    archive: string;
+    encrypted: boolean;
+    warning: string;
+}>;
+export declare function runSelfHostedRestore(input: RuntimeInput & {
+    archive: string;
+    passphrase?: string;
+    yes: boolean;
+    isTty: boolean;
+    replaceExisting?: boolean;
+    confirmName?: () => Promise<string>;
+}): Promise<{
+    edition: "selfhosted";
+    version: string;
+    platformName: string;
+    integrityChecked: boolean;
+    healthPassed: boolean;
+    next: string;
+    warning: string;
+}>;
+export {};
+//# sourceMappingURL=selfhosted-backup.d.ts.map

package/dist/lib/selfhosted-backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selfhosted-backup.d.ts","sourceRoot":"","sources":["../../src/lib/selfhosted-backup.ts"],"names":[],"mappings":"AA4BA,OAAO,EAML,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,UAAU,YAAY;IACpB,KAAK,EAAE,aAAa,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,aAAa,GAAG,kBAAkB,CAAC;IAC3C,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;AA8ED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,YAAY,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;aAiDxE,MAAM;eAAa,OAAO;aAAW,MAAM;GAuOrE;AACD,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,YAAY,GAAG;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CACrC;;;;;;;;GAkRF"}