@knowzai/cli 0.4.0 → 0.5.0

package/dist/lib/runtime-discovery.js

@@ -0,0 +1,56 @@
+import { savedLocalEngine } from './local-engine-context.js';
+import { join } from 'node:path';
+import { existsSync, readFileSync } from 'node:fs';
+import { resolvePlatformPaths, validatePort, validateProjectName, validateProviderPreset } from './platform-runtime.js';
+import { resolveSelfHostedPaths } from './selfhosted-lifecycle.js';
+/** One selector for setup, terminal and lifecycle commands. Unknown/corrupt state is never a fresh install. */
+export function discoverRuntime(input) {
+    validateProjectName(input.name);
+    const candidates = (input.edition ? [input.edition] : ['selfhosted', 'portable']).map(edition => {
+        const sh = resolveSelfHostedPaths(input.name, input.configDir);
+        const paths = edition === 'portable' ? resolvePlatformPaths(input.name, input.configDir) : {
+            runtimeDir: sh.root, composeFile: sh.composeFile, envFile: sh.envFile, stateFile: sh.stateFile, postgresInitDir: sh.root,
+        };
+        return { edition, paths };
+    }).filter(candidate => existsSync(candidate.paths.stateFile) || existsSync(join(candidate.paths.runtimeDir, 'attempt.json')));
+    if (candidates.length > 1)
+        throw new Error(`Runtime '${input.name}' exists in both editions. Select --edition selfhosted or --edition portable.`);
+    if (!candidates.length)
+        return undefined;
+    const { edition, paths } = candidates[0];
+    try {
+        const hasHealthyState = existsSync(paths.stateFile);
+        const attemptPath = join(paths.runtimeDir, 'attempt.json');
+        const attempt = existsSync(attemptPath) ? JSON.parse(readFileSync(attemptPath, 'utf8')) : undefined;
+        const parsed = (hasHealthyState ? JSON.parse(readFileSync(paths.stateFile, 'utf8')) : attempt?.state);
+        if (parsed.name !== input.name || typeof parsed.version !== 'string' || !/^\d+\.\d+\.\d+(?:-[\w.-]+)?(?:\+[\w.-]+)?$/.test(parsed.version) || !parsed.ports)
+            throw new Error('Missing name, version or ports');
+        if (parsed.edition && parsed.edition !== edition)
+            throw new Error('Edition does not match runtime directory');
+        const ports = { api: validatePort(parsed.ports.api), web: validatePort(parsed.ports.web), mcp: validatePort(parsed.ports.mcp), publicSite: validatePort(parsed.ports.publicSite ?? (edition === 'selfhosted' ? parsed.ports.web : 3002)) };
+        const safeUrl = (value, port) => {
+            if (typeof value !== 'string')
+                return `http://localhost:${port}`;
+            const url = new URL(value);
+            if (!['http:', 'https:'].includes(url.protocol) || url.username || url.password)
+                throw new Error('Invalid service URL');
+            return value;
+        };
+        const state = {
+            schemaVersion: 1, name: input.name, version: parsed.version,
+            provider: validateProviderPreset(parsed.provider ?? 'offline'),
+            storage: parsed.storage === 'minio' ? 'minio' : 'filesystem', imageFlavor: parsed.imageFlavor === '-gcp' ? '-gcp' : '',
+            axes: { ai: undefined, docIntelligence: 'None', vision: 'None', transcription: 'None' },
+            ports,
+            serviceUrls: { api: safeUrl(parsed.serviceUrls?.api, ports.api), web: safeUrl(parsed.serviceUrls?.web, ports.web), mcp: safeUrl(parsed.serviceUrls?.mcp, ports.mcp), publicSite: safeUrl(parsed.serviceUrls?.publicSite, ports.publicSite) },
+            components: { mcp: parsed.components?.mcp !== false, publicSite: edition === 'portable' && parsed.components?.publicSite === true },
+            imageMode: parsed.imageMode === 'preloaded' || parsed.imageMode === 'build' ? parsed.imageMode : 'pull',
+            updatedAt: typeof parsed.updatedAt === 'string' ? parsed.updatedAt : '',
+        };
+        return { edition, paths, state, hasHealthyState: hasHealthyState && parsed.healthPassed !== false, ...(attempt?.status ? { attemptStatus: attempt.status } : {}), ...(parsed.engine === undefined ? {} : { engine: savedLocalEngine(parsed.engine) }) };
+    }
+    catch (error) {
+        throw new Error(`Invalid ${edition} runtime state at ${paths.stateFile}: ${error instanceof Error ? error.message : 'unreadable state'}. Repair or restore this state before continuing.`);
+    }
+}
+//# sourceMappingURL=runtime-discovery.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-discovery.js","sourceRoot":"","sources":["../../src/lib/runtime-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,mBAAmB,EAAE,sBAAsB,EAA0C,MAAM,uBAAuB,CAAC;AAChK,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAKnE,+GAA+G;AAC/G,MAAM,UAAU,eAAe,CAAC,KAAsE;IACpG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,UAAU,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,UAAU,CAAU,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;QACvG,MAAM,EAAE,GAAG,sBAAsB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAC/D,MAAM,KAAK,GAAG,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACzF,UAAU,EAAE,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,eAAe,EAAE,EAAE,CAAC,IAAI;SACzH,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IAC9H,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,YAAY,KAAK,CAAC,IAAI,+EAA+E,CAAC,CAAC;IAClJ,IAAI,CAAC,UAAU,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,eAAe,GAAG,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACpD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAyC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5I,MAAM,MAAM,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAA4F,CAAC;QACjM,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,4CAA4C,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAC/M,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9G,MAAM,KAAK,GAAG,EAAE,GAAG,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,OAAO,KAAK,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC3O,MAAM,OAAO,GAAG,CAAC,KAAc,EAAE,IAAY,EAAE,EAAE;YAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,oBAAoB,IAAI,EAAE,CAAC;YACjE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;YAC3B,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;YACxH,OAAO,KAAK,CAAC;QACf,CAAC,CAAC;QACF,MAAM,KAAK,GAAkB;YAC3B,aAAa,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO;YAC3D,QAAQ,EAAE,sBAAsB,CAAC,MAAM,CAAC,QAAQ,IAAI,SAAS,CAAC;YAC9D,OAAO,EAAE,MAAM,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;YACtH,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE;YACvF,KAAK;YACL,WAAW,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE;YAC5O,UAAU,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,KAAK,KAAK,EAAE,UAAU,EAAE,OAAO,KAAK,UAAU,IAAI,MAAM,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,EAAE;YACnI,SAAS,EAAE,MAAM,CAAC,SAAS,KAAK,WAAW,IAAI,MAAM,CAAC,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;YACvG,SAAS,EAAE,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;SACxE,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,eAAe,IAAI,MAAM,CAAC,YAAY,KAAK,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;IAC1P,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,WAAW,OAAO,qBAAqB,KAAK,CAAC,SAAS,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,mDAAmD,CAAC,CAAC;IAAC,CAAC;AACjN,CAAC"}

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

@@ -0,0 +1,3 @@
+/** Exclusive local mutation lease. Stale leases are removed only after the recorded process has exited. */
+export declare function acquireRuntimeLock(runtimeDir: string): () => void;
+//# sourceMappingURL=runtime-lock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-lock.d.ts","sourceRoot":"","sources":["../../src/lib/runtime-lock.ts"],"names":[],"mappings":"AAIA,2GAA2G;AAC3G,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,IAAI,CAwBjE"}

package/dist/lib/runtime-lock.js

@@ -0,0 +1,50 @@
+import { closeSync, mkdirSync, openSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+/** Exclusive local mutation lease. Stale leases are removed only after the recorded process has exited. */
+export function acquireRuntimeLock(runtimeDir) {
+    const path = join(runtimeDir, '.operation.lock');
+    mkdirSync(dirname(path), { recursive: true });
+    const token = randomUUID();
+    for (let attempt = 0; attempt < 2; attempt++) {
+        try {
+            const fd = openSync(path, 'wx', 0o600);
+            try {
+                writeFileSync(fd, JSON.stringify({ pid: process.pid, token }));
+            }
+            finally {
+                closeSync(fd);
+            }
+            return () => {
+                try {
+                    if (JSON.parse(readFileSync(path, 'utf8')).token === token)
+                        unlinkSync(path);
+                }
+                catch { /* Already released. */ }
+            };
+        }
+        catch (error) {
+            if (error.code !== 'EEXIST')
+                throw error;
+            let pid;
+            try {
+                pid = JSON.parse(readFileSync(path, 'utf8')).pid;
+            }
+            catch { /* Unknown owner remains locked. */ }
+            if (typeof pid === 'number' && Number.isSafeInteger(pid) && pid > 0) {
+                try {
+                    process.kill(pid, 0);
+                }
+                catch (probeError) {
+                    if (probeError.code === 'ESRCH' && attempt === 0) {
+                        unlinkSync(path);
+                        continue;
+                    }
+                }
+            }
+            throw Object.assign(new Error('This runtime is busy with another operation. Wait for it to finish, then retry.'), { code: 'RUNTIME_BUSY', exitCode: 3 });
+        }
+    }
+    throw new Error('Unable to acquire runtime lock.');
+}
+//# sourceMappingURL=runtime-lock.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-lock.js","sourceRoot":"","sources":["../../src/lib/runtime-lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClG,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,2GAA2G;AAC3G,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;IACjD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YACvC,IAAI,CAAC;gBAAC,aAAa,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YAAC,CAAC;oBAAS,CAAC;gBAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAAC,CAAC;YAClG,OAAO,GAAG,EAAE;gBACV,IAAI,CAAC;oBAAC,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK;wBAAE,UAAU,CAAC,IAAI,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,uBAAuB,CAAC,CAAC;YACzH,CAAC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,KAAK,CAAC;YACpE,IAAI,GAAY,CAAC;YACjB,IAAI,CAAC;gBAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,mCAAmC,CAAC,CAAC;YACvG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;gBACpE,IAAI,CAAC;oBAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBAAC,CAAC;gBAAC,OAAO,UAAU,EAAE,CAAC;oBAChD,IAAK,UAAoC,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;wBAAC,UAAU,CAAC,IAAI,CAAC,CAAC;wBAAC,SAAS;oBAAC,CAAC;gBAC9G,CAAC;YACH,CAAC;YACD,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,iFAAiF,CAAC,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3J,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;AACrD,CAAC"}

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

@@ -0,0 +1,98 @@
+import { type CredentialStore, type KnowzConfig } from '@knowzai/core';
+import type { PlatformEdition } from './platform-edition.js';
+import { applyPlatform } from './platform-lifecycle.js';
+import { applySelfHostedAsync } from './selfhosted-lifecycle.js';
+import { type EngineStatus } from './container-engine.js';
+import { type ProcessRunner, type AsyncProcessRunner } from './platform-runtime.js';
+import { type RuntimeProviderProbeDeps } from './runtime-provider.js';
+export { parseComposeStatus } from './compose-status.js';
+export type RuntimeAction = 'status' | 'logs' | 'doctor' | 'down' | 'destroy' | 'upgrade';
+export interface RuntimeOperationInput {
+    name: string;
+    configDir?: string;
+    edition?: PlatformEdition;
+    version?: string;
+    confirmed?: boolean;
+    purgeProfile?: boolean;
+    tail?: number;
+}
+export interface RuntimeOperationDeps extends RuntimeProviderProbeDeps {
+    runner?: ProcessRunner | AsyncProcessRunner;
+    engine?: EngineStatus;
+    /** Injectable observed engine endpoint; production reads Docker's context or the Podman socket. */
+    contextHost?: string;
+    env?: Readonly<Record<string, string | undefined>>;
+    applyPortable?: typeof applyPlatform;
+    applySelfHosted?: typeof applySelfHostedAsync;
+    selfHostedAssetsDir?: string;
+    loadConfig?: () => KnowzConfig;
+    saveConfig?: (config: KnowzConfig) => void;
+    credentialStore?: () => Promise<CredentialStore>;
+}
+export declare function runRuntimeOperation(action: RuntimeAction, input: RuntimeOperationInput, deps?: RuntimeOperationDeps): Promise<{
+    installedVersion: string;
+    upgraded: boolean;
+    output: string;
+    action: RuntimeAction;
+    name: string;
+    edition: "selfhosted" | "portable";
+    runtimeDir: string;
+    engine: import("./container-engine.js").ContainerEngineId;
+} | {
+    destroyed: boolean;
+    volumesDeleted: boolean;
+    profilePurged: boolean;
+    output: string;
+    action: RuntimeAction;
+    name: string;
+    edition: "selfhosted" | "portable";
+    installedVersion: string;
+    runtimeDir: string;
+    engine: import("./container-engine.js").ContainerEngineId;
+} | {
+    stopped: boolean;
+    volumesPreserved: boolean;
+    output: string;
+    action: RuntimeAction;
+    name: string;
+    edition: "selfhosted" | "portable";
+    installedVersion: string;
+    runtimeDir: string;
+    engine: import("./container-engine.js").ContainerEngineId;
+} | {
+    output: string;
+    action: RuntimeAction;
+    name: string;
+    edition: "selfhosted" | "portable";
+    installedVersion: string;
+    runtimeDir: string;
+    engine: import("./container-engine.js").ContainerEngineId;
+} | {
+    output: string;
+    provider: {
+        mode: "offline" | "azure" | "gcp" | "knowz-cloud" | "openai-compatible";
+        configured: boolean;
+        connectivity: "not-checked";
+        detail: string;
+    } | {
+        connectivity: "reachable" | "unavailable";
+        authentication: "not-checked";
+        model: "not-checked";
+        mode: "offline" | "azure" | "gcp" | "knowz-cloud" | "openai-compatible";
+        configured: boolean;
+        detail: string;
+    };
+    desiredVersion?: string | undefined;
+    versionSources: import("./platform-lifecycle.js").PlatformVersionSources;
+    versionConsistent: boolean;
+    status: string;
+    checks: import("./runtime-status.js").RuntimeCheck[];
+    services: import("./compose-status.js").ComposeStatusRow[];
+    action: RuntimeAction;
+    name: string;
+    edition: "selfhosted" | "portable";
+    installedVersion: string;
+    runtimeDir: string;
+    engine: import("./container-engine.js").ContainerEngineId;
+}>;
+//# sourceMappingURL=runtime-operations.d.ts.map

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: "reachable" | "unavailable";
+    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":"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"}

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"}