@alvax-ai/opc 0.1.0

package/dist/commands/run.d.ts

@@ -0,0 +1,11 @@
+type RunOptions = {
+    instance?: string;
+    home?: string;
+    dataDir?: string;
+    host?: string;
+    port?: string;
+    open?: boolean;
+};
+export declare function runCommand(opts: RunOptions): Promise<void>;
+export {};
+//# sourceMappingURL=run.d.ts.map

package/dist/commands/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAaA,KAAK,UAAU,GAAG;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AA4EF,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA2DhE"}

package/dist/commands/run.js

@@ -0,0 +1,121 @@
+import fs from "node:fs";
+import path from "node:path";
+import open from "open";
+import pc from "picocolors";
+import { loadAlvaxEnvFile } from "../config/env.js";
+import { describeLocalInstancePaths, expandHomePrefix, resolveAlvaxHomeDir, resolveAlvaxInstanceId, } from "../config/home.js";
+import { printBrowserFallback, printStartupBanner } from "../startup-banner.js";
+function setDefaultEnv(key, value) {
+    if (process.env[key]?.trim())
+        return;
+    process.env[key] = value;
+}
+function setOptionEnv(key, value) {
+    const trimmed = value?.trim();
+    if (!trimmed)
+        return;
+    process.env[key] = trimmed;
+}
+function parsePort(raw) {
+    if (raw === undefined)
+        return undefined;
+    const value = raw.trim();
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 1 || parsed > 65535) {
+        throw new Error(`Invalid port '${raw}'. Expected a number between 1 and 65535.`);
+    }
+    return String(parsed);
+}
+function resolveHomeOverride(opts) {
+    const raw = opts.home?.trim() || opts.dataDir?.trim();
+    if (!raw)
+        return null;
+    return path.resolve(expandHomePrefix(raw));
+}
+async function importServerEntry() {
+    // Keep the specifier widened so CLI typecheck does not compile server source.
+    const serverPackageName = "@alvax-ai/server";
+    const mod = await import(serverPackageName);
+    const startServer = mod.startServer;
+    if (typeof startServer !== "function") {
+        throw new Error("@alvax-ai/server did not export startServer(). Rebuild or reinstall Alvax.");
+    }
+    return { startServer };
+}
+async function openBrowser(url) {
+    try {
+        await open(url);
+    }
+    catch {
+        printBrowserFallback(url);
+    }
+}
+async function presentStartedServer(startedServer, opts) {
+    printStartupBanner({
+        apiUrl: startedServer.apiUrl,
+        uiUrl: startedServer.uiUrl,
+        uiMode: startedServer.uiMode,
+    });
+    const browserUrl = startedServer.uiUrl;
+    if (browserUrl) {
+        if (opts.open !== false) {
+            await openBrowser(browserUrl);
+        }
+    }
+    else {
+        console.log(pc.yellow(`UI is disabled. API URL: ${startedServer.apiUrl}`));
+    }
+}
+export async function runCommand(opts) {
+    const homeOverride = resolveHomeOverride(opts);
+    if (homeOverride)
+        process.env.ALVAX_HOME = homeOverride;
+    process.env.ALVAX_HOME = resolveAlvaxHomeDir();
+    const instanceId = resolveAlvaxInstanceId(opts.instance);
+    process.env.ALVAX_INSTANCE_ID = instanceId;
+    const paths = describeLocalInstancePaths(instanceId);
+    fs.mkdirSync(paths.instanceRoot, { recursive: true });
+    loadAlvaxEnvFile(instanceId);
+    setOptionEnv("ALVAX_HOST", opts.host);
+    setOptionEnv("ALVAX_PORT", parsePort(opts.port));
+    setDefaultEnv("ALVAX_HOST", "127.0.0.1");
+    setDefaultEnv("ALVAX_PORT", "3100");
+    setDefaultEnv("ALVAX_UI_MODE", "static");
+    setDefaultEnv("ALVAX_CONSOLE_LOG_LEVEL", process.env.ALVAX_LOG_LEVEL?.trim() || "warn");
+    setDefaultEnv("ALVAX_HTTP_SUCCESS_LOGS", "false");
+    console.log(pc.cyan("Starting Alvax..."));
+    let startedServer = null;
+    let startPromise = null;
+    let shuttingDown = false;
+    const shutdown = (signal) => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        void (async () => {
+            try {
+                await startPromise?.catch(() => { });
+                await startedServer?.stop();
+            }
+            catch (err) {
+                console.error(`Failed to stop Alvax cleanly after ${signal}:`, err instanceof Error ? err.message : String(err));
+            }
+            finally {
+                process.exit(0);
+            }
+        })();
+    };
+    process.once("SIGINT", () => shutdown("SIGINT"));
+    process.once("SIGTERM", () => shutdown("SIGTERM"));
+    startPromise = (async () => {
+        const { startServer } = await importServerEntry();
+        const server = await startServer();
+        startedServer = server;
+        if (shuttingDown) {
+            await server.stop();
+            return;
+        }
+        await presentStartedServer(server, opts);
+    })();
+    await startPromise;
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

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

package/dist/config/env.d.ts

@@ -0,0 +1,3 @@
+export declare function resolveAlvaxEnvFile(instanceId?: string): string;
+export declare function loadAlvaxEnvFile(instanceId?: string): void;
+//# sourceMappingURL=env.d.ts.map

package/dist/config/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/config/env.ts"],"names":[],"mappings":"AAMA,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,gBAAgB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAO1D"}

package/dist/config/env.js

@@ -0,0 +1,17 @@
+import fs from "node:fs";
+import { config as loadDotenv } from "dotenv";
+import { resolveDefaultEnvPath } from "./home.js";
+const loadedEnvFiles = new Set();
+export function resolveAlvaxEnvFile(instanceId) {
+    return resolveDefaultEnvPath(instanceId);
+}
+export function loadAlvaxEnvFile(instanceId) {
+    const filePath = resolveAlvaxEnvFile(instanceId);
+    if (loadedEnvFiles.has(filePath))
+        return;
+    if (!fs.existsSync(filePath))
+        return;
+    loadedEnvFiles.add(filePath);
+    loadDotenv({ path: filePath, override: false, quiet: true });
+}
+//# sourceMappingURL=env.js.map

package/dist/config/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/config/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAElD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;AAEzC,MAAM,UAAU,mBAAmB,CAAC,UAAmB;IACrD,OAAO,qBAAqB,CAAC,UAAU,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAAmB;IAClD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IACjD,IAAI,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO;IACzC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO;IAErC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7B,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC/D,CAAC"}

package/dist/config/home.d.ts

@@ -0,0 +1,18 @@
+export declare function expandHomePrefix(value: string): string;
+export declare function resolveAlvaxHomeDir(): string;
+export declare function resolveAlvaxInstanceId(override?: string): string;
+export declare function resolveAlvaxInstanceRoot(instanceId?: string): string;
+export declare function resolveDefaultEmbeddedPostgresDir(instanceId?: string): string;
+export declare function resolveDefaultStorageDir(instanceId?: string): string;
+export declare function resolveDefaultLogsDir(instanceId?: string): string;
+export declare function resolveDefaultEnvPath(instanceId?: string): string;
+export declare function describeLocalInstancePaths(instanceId?: string): {
+    homeDir: string;
+    instanceId: string;
+    instanceRoot: string;
+    envPath: string;
+    embeddedPostgresDataDir: string;
+    logDir: string;
+    storageDir: string;
+};
+//# sourceMappingURL=home.d.ts.map

package/dist/config/home.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"home.d.ts","sourceRoot":"","sources":["../../src/config/home.ts"],"names":[],"mappings":"AAMA,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAItD;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAI5C;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAQhE;AAED,wBAAgB,wBAAwB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAgB,iCAAiC,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED,wBAAgB,wBAAwB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAgB,qBAAqB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAgB,qBAAqB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAgB,0BAA0B,CAAC,UAAU,CAAC,EAAE,MAAM;;;;;;;;EAY7D"}

package/dist/config/home.js

@@ -0,0 +1,53 @@
+import os from "node:os";
+import path from "node:path";
+const DEFAULT_INSTANCE_ID = "default";
+const INSTANCE_ID_RE = /^[a-zA-Z0-9_-]+$/;
+export function expandHomePrefix(value) {
+    if (value === "~")
+        return os.homedir();
+    if (value.startsWith("~/"))
+        return path.resolve(os.homedir(), value.slice(2));
+    return value;
+}
+export function resolveAlvaxHomeDir() {
+    const envHome = process.env.ALVAX_HOME?.trim();
+    if (envHome)
+        return path.resolve(expandHomePrefix(envHome));
+    return path.resolve(os.homedir(), ".alvax");
+}
+export function resolveAlvaxInstanceId(override) {
+    const raw = override?.trim() || process.env.ALVAX_INSTANCE_ID?.trim() || DEFAULT_INSTANCE_ID;
+    if (!INSTANCE_ID_RE.test(raw)) {
+        throw new Error(`Invalid instance id '${raw}'. Allowed characters: letters, numbers, '_' and '-'.`);
+    }
+    return raw;
+}
+export function resolveAlvaxInstanceRoot(instanceId) {
+    return path.resolve(resolveAlvaxHomeDir(), "instances", resolveAlvaxInstanceId(instanceId));
+}
+export function resolveDefaultEmbeddedPostgresDir(instanceId) {
+    return path.resolve(resolveAlvaxInstanceRoot(instanceId), "db");
+}
+export function resolveDefaultStorageDir(instanceId) {
+    return path.resolve(resolveAlvaxInstanceRoot(instanceId), "data", "storage");
+}
+export function resolveDefaultLogsDir(instanceId) {
+    return path.resolve(resolveAlvaxInstanceRoot(instanceId), "logs");
+}
+export function resolveDefaultEnvPath(instanceId) {
+    return path.resolve(resolveAlvaxInstanceRoot(instanceId), ".env");
+}
+export function describeLocalInstancePaths(instanceId) {
+    const resolvedInstanceId = resolveAlvaxInstanceId(instanceId);
+    const instanceRoot = resolveAlvaxInstanceRoot(resolvedInstanceId);
+    return {
+        homeDir: resolveAlvaxHomeDir(),
+        instanceId: resolvedInstanceId,
+        instanceRoot,
+        envPath: resolveDefaultEnvPath(resolvedInstanceId),
+        embeddedPostgresDataDir: resolveDefaultEmbeddedPostgresDir(resolvedInstanceId),
+        logDir: resolveDefaultLogsDir(resolvedInstanceId),
+        storageDir: resolveDefaultStorageDir(resolvedInstanceId),
+    };
+}
+//# sourceMappingURL=home.js.map

package/dist/config/home.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"home.js","sourceRoot":"","sources":["../../src/config/home.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,mBAAmB,GAAG,SAAS,CAAC;AACtC,MAAM,cAAc,GAAG,kBAAkB,CAAC;AAE1C,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,IAAI,KAAK,KAAK,GAAG;QAAE,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC;IACvC,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC;IAC/C,IAAI,OAAO;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAiB;IACtD,MAAM,GAAG,GAAG,QAAQ,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,IAAI,mBAAmB,CAAC;IAC7F,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,wBAAwB,GAAG,uDAAuD,CACnF,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,UAAmB;IAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,WAAW,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,UAAmB;IACnE,OAAO,IAAI,CAAC,OAAO,CAAC,wBAAwB,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,UAAmB;IAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,wBAAwB,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,UAAmB;IACvD,OAAO,IAAI,CAAC,OAAO,CAAC,wBAAwB,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,UAAmB;IACvD,OAAO,IAAI,CAAC,OAAO,CAAC,wBAAwB,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,UAAmB;IAC5D,MAAM,kBAAkB,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAC9D,MAAM,YAAY,GAAG,wBAAwB,CAAC,kBAAkB,CAAC,CAAC;IAClE,OAAO;QACL,OAAO,EAAE,mBAAmB,EAAE;QAC9B,UAAU,EAAE,kBAAkB;QAC9B,YAAY;QACZ,OAAO,EAAE,qBAAqB,CAAC,kBAAkB,CAAC;QAClD,uBAAuB,EAAE,iCAAiC,CAAC,kBAAkB,CAAC;QAC9E,MAAM,EAAE,qBAAqB,CAAC,kBAAkB,CAAC;QACjD,UAAU,EAAE,wBAAwB,CAAC,kBAAkB,CAAC;KACzD,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare const cliVersion = "0.1.0";
+//# 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":";AAIA,eAAO,MAAM,UAAU,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { runCommand } from "./commands/run.js";
+export const cliVersion = "0.1.0";
+const program = new Command();
+program
+    .name("alvax-opc")
+    .description("Alvax OPC command line interface")
+    .version(cliVersion);
+program
+    .command("run")
+    .description("Start the local Alvax server")
+    .option("-i, --instance <id>", "Local instance id (default: default)")
+    .option("--home <path>", "Alvax home directory root (default: ~/.alvax)")
+    .option("-d, --data-dir <path>", "Alias for --home")
+    .option("--host <host>", "Server host (default: 127.0.0.1)")
+    .option("--port <port>", "Server port (default: 3100)")
+    .option("--no-open", "Do not open the browser automatically")
+    .action(runCommand);
+async function main() {
+    try {
+        await program.parseAsync();
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+}
+void main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC;AAElC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,kCAAkC,CAAC;KAC/C,OAAO,CAAC,UAAU,CAAC,CAAC;AAEvB,OAAO;KACJ,OAAO,CAAC,KAAK,CAAC;KACd,WAAW,CAAC,8BAA8B,CAAC;KAC3C,MAAM,CAAC,qBAAqB,EAAE,sCAAsC,CAAC;KACrE,MAAM,CAAC,eAAe,EAAE,+CAA+C,CAAC;KACxE,MAAM,CAAC,uBAAuB,EAAE,kBAAkB,CAAC;KACnD,MAAM,CAAC,eAAe,EAAE,kCAAkC,CAAC;KAC3D,MAAM,CAAC,eAAe,EAAE,6BAA6B,CAAC;KACtD,MAAM,CAAC,WAAW,EAAE,uCAAuC,CAAC;KAC5D,MAAM,CAAC,UAAU,CAAC,CAAC;AAEtB,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,KAAK,IAAI,EAAE,CAAC"}

package/dist/startup-banner.d.ts

@@ -0,0 +1,9 @@
+type StartupBannerOptions = {
+    apiUrl: string;
+    uiUrl: string | null;
+    uiMode: string;
+};
+export declare function printStartupBanner(opts: StartupBannerOptions): void;
+export declare function printBrowserFallback(url: string): void;
+export {};
+//# sourceMappingURL=startup-banner.d.ts.map

package/dist/startup-banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-banner.d.ts","sourceRoot":"","sources":["../src/startup-banner.ts"],"names":[],"mappings":"AAAA,KAAK,oBAAoB,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAaF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAYnE;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEtD"}

package/dist/startup-banner.js

@@ -0,0 +1,24 @@
+const ansi = {
+    reset: "\x1b[0m",
+    dim: "\x1b[2m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+};
+function color(text, c) {
+    return `${ansi[c]}${text}${ansi.reset}`;
+}
+export function printStartupBanner(opts) {
+    const url = opts.uiUrl ?? opts.apiUrl;
+    const label = opts.uiMode === "none" ? "API URL" : "Open";
+    const lines = [
+        "",
+        color("Alvax is running", "green"),
+        `${color(label, "dim")}: ${url}`,
+        "",
+    ];
+    console.log(lines.join("\n"));
+}
+export function printBrowserFallback(url) {
+    console.log(`${color("Browser did not open automatically.", "yellow")} Open manually: ${url}`);
+}
+//# sourceMappingURL=startup-banner.js.map

package/dist/startup-banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-banner.js","sourceRoot":"","sources":["../src/startup-banner.ts"],"names":[],"mappings":"AAMA,MAAM,IAAI,GAAG;IACX,KAAK,EAAE,SAAS;IAChB,GAAG,EAAE,SAAS;IACd,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;CACnB,CAAC;AAEF,SAAS,KAAK,CAAC,IAAY,EAAE,CAAoB;IAC/C,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAA0B;IAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;IAE1D,MAAM,KAAK,GAAG;QACZ,EAAE;QACF,KAAK,CAAC,kBAAkB,EAAE,OAAO,CAAC;QAClC,GAAG,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,EAAE;QAChC,EAAE;KACH,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,qCAAqC,EAAE,QAAQ,CAAC,mBAAmB,GAAG,EAAE,CAAC,CAAC;AACjG,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@alvax-ai/opc",
+  "version": "0.1.0",
+  "description": "Alvax OPC command line interface",
+  "type": "module",
+  "bin": {
+    "alvax-opc": "./dist/index.js"
+  },
+  "keywords": [
+    "alvax",
+    "agents",
+    "orchestration",
+    "cli"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/varlife/alvax-mono-v2",
+  "bugs": {
+    "url": "https://github.com/varlife/alvax-mono-v2/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/varlife/alvax-mono-v2",
+    "directory": "packages/cli"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@alvax-ai/db": "0.1.0",
+    "@alvax-ai/server": "0.1.0",
+    "commander": "^13.1.0",
+    "dotenv": "^17.0.1",
+    "open": "^11.0.0",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2"
+  },
+  "scripts": {
+    "dev": "tsx --conditions development src/index.ts",
+    "build": "tsc && chmod +x dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}