@nodetool-ai/config 0.7.0-rc.11

package/dist/diagnostics.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Environment diagnostics — T-CFG-4.
+ *
+ * Enumerates registered settings and reports their status with
+ * masked values for secrets.
+ */
+import { type SettingStatus } from "./settings.js";
+export interface DiagnosticResult {
+    key: string;
+    group: string;
+    isSet: boolean;
+    isSecret: boolean;
+    maskedValue: string | null;
+    description: string;
+}
+/**
+ * Mask a secret value: show first 4 + last 4 chars with `***` in between.
+ * For short values (<=8 chars), mask entirely as `***`.
+ */
+export declare function maskSecret(value: string): string;
+/**
+ * Diagnose the current environment by checking all registered settings.
+ *
+ * @param settings Optional override — defaults to `getSettings()`.
+ */
+export declare function diagnoseEnvironment(settings?: SettingStatus[]): DiagnosticResult[];
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,CAAC,EAAE,aAAa,EAAE,GACzB,gBAAgB,EAAE,CAqBpB"}

package/dist/diagnostics.js

@@ -0,0 +1,42 @@
+/**
+ * Environment diagnostics — T-CFG-4.
+ *
+ * Enumerates registered settings and reports their status with
+ * masked values for secrets.
+ */
+import { getSettings } from "./settings.js";
+/**
+ * Mask a secret value: show first 4 + last 4 chars with `***` in between.
+ * For short values (<=8 chars), mask entirely as `***`.
+ */
+export function maskSecret(value) {
+    if (value.length <= 8) {
+        return "***";
+    }
+    return `${value.slice(0, 4)}***${value.slice(-4)}`;
+}
+/**
+ * Diagnose the current environment by checking all registered settings.
+ *
+ * @param settings Optional override — defaults to `getSettings()`.
+ */
+export function diagnoseEnvironment(settings) {
+    const resolved = settings ?? getSettings();
+    return resolved.map((setting) => {
+        const envValue = process.env[setting.envVar];
+        const isSet = !!envValue;
+        let maskedValue = null;
+        if (isSet && envValue) {
+            maskedValue = setting.isSecret ? maskSecret(envValue) : envValue;
+        }
+        return {
+            key: setting.envVar,
+            group: setting.group,
+            isSet,
+            isSecret: setting.isSecret,
+            maskedValue,
+            description: setting.description
+        };
+    });
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAsB,MAAM,eAAe,CAAC;AAWhE;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAA0B;IAE1B,MAAM,QAAQ,GAAG,QAAQ,IAAI,WAAW,EAAE,CAAC;IAE3C,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAC9B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,CAAC;QAEzB,IAAI,WAAW,GAAkB,IAAI,CAAC;QACtC,IAAI,KAAK,IAAI,QAAQ,EAAE,CAAC;YACtB,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QACnE,CAAC;QAED,OAAO;YACL,GAAG,EAAE,OAAO,CAAC,MAAM;YACnB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK;YACL,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,WAAW;YACX,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/environment.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Load environment files in the correct order.
+ * System env vars always take precedence over file values.
+ *
+ * @param rootDir - Directory containing .env files. Defaults to cwd.
+ */
+export declare function loadEnvironment(rootDir?: string): void;
+/**
+ * Get an environment variable value.
+ * Falls back to process.env if loadEnvironment hasn't been called.
+ */
+export declare function getEnv(key: string, defaultValue?: string): string | undefined;
+/**
+ * Get a required environment variable. Throws if not set.
+ */
+export declare function requireEnv(key: string): string;
+/**
+ * Reset the loader state (for testing).
+ */
+export declare function resetEnvironment(): void;
+//# sourceMappingURL=environment.d.ts.map

package/dist/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAaA;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAqCtD;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK7E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM9C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC"}

package/dist/environment.js

@@ -0,0 +1,77 @@
+/**
+ * Environment loader — T-CFG-1.
+ *
+ * Loads .env files in order: .env, .env.{NODE_ENV}, .env.{NODE_ENV}.local
+ * Later files override earlier ones. System env vars always win.
+ */
+import { config as dotenvConfig } from "dotenv";
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+let loaded = false;
+const envStore = new Map();
+/**
+ * Load environment files in the correct order.
+ * System env vars always take precedence over file values.
+ *
+ * @param rootDir - Directory containing .env files. Defaults to cwd.
+ */
+export function loadEnvironment(rootDir) {
+    const root = rootDir ?? process.cwd();
+    const nodeEnv = process.env.NODE_ENV ?? "development";
+    // Load files in order: .env, .env.{NODE_ENV}, .env.{NODE_ENV}.local
+    const files = [
+        resolve(root, ".env"),
+        resolve(root, `.env.${nodeEnv}`),
+        resolve(root, `.env.${nodeEnv}.local`)
+    ];
+    // Start fresh
+    envStore.clear();
+    // Snapshot system env before loading files
+    const systemEnv = { ...process.env };
+    for (const file of files) {
+        if (existsSync(file)) {
+            const result = dotenvConfig({ path: file, override: true });
+            if (result.parsed) {
+                for (const [key, value] of Object.entries(result.parsed)) {
+                    envStore.set(key, value);
+                }
+            }
+        }
+    }
+    // System env always wins — restore original system values on top
+    for (const [key, value] of Object.entries(systemEnv)) {
+        if (value !== undefined) {
+            envStore.set(key, value);
+            process.env[key] = value;
+        }
+    }
+    loaded = true;
+}
+/**
+ * Get an environment variable value.
+ * Falls back to process.env if loadEnvironment hasn't been called.
+ */
+export function getEnv(key, defaultValue) {
+    if (loaded) {
+        return envStore.get(key) ?? defaultValue;
+    }
+    return process.env[key] ?? defaultValue;
+}
+/**
+ * Get a required environment variable. Throws if not set.
+ */
+export function requireEnv(key) {
+    const value = getEnv(key);
+    if (value === undefined || value === "") {
+        throw new Error(`Required environment variable ${key} is not set`);
+    }
+    return value;
+}
+/**
+ * Reset the loader state (for testing).
+ */
+export function resetEnvironment() {
+    envStore.clear();
+    loaded = false;
+}
+//# sourceMappingURL=environment.js.map

package/dist/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,IAAI,MAAM,GAAG,KAAK,CAAC;AACnB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,MAAM,IAAI,GAAG,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,aAAa,CAAC;IAEtD,oEAAoE;IACpE,MAAM,KAAK,GAAG;QACZ,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,OAAO,EAAE,CAAC;QAChC,OAAO,CAAC,IAAI,EAAE,QAAQ,OAAO,QAAQ,CAAC;KACvC,CAAC;IAEF,cAAc;IACd,QAAQ,CAAC,KAAK,EAAE,CAAC;IAEjB,2CAA2C;IAC3C,MAAM,SAAS,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAErC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5D,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;oBACzD,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBAC3B,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,MAAM,GAAG,IAAI,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,GAAW,EAAE,YAAqB;IACvD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC;IAC3C,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,iCAAiC,GAAG,aAAa,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,QAAQ,CAAC,KAAK,EAAE,CAAC;IACjB,MAAM,GAAG,KAAK,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { loadEnvironment, getEnv, requireEnv, resetEnvironment } from "./environment.js";
+export { registerSetting, getSettings, clearSettings, type SettingDefinition, type SettingStatus } from "./settings.js";
+export { configureLogging, getLogLevel, createLogger, type LogLevel, type LoggingOptions, type Logger } from "./logging.js";
+export { diagnoseEnvironment, maskSecret, type DiagnosticResult } from "./diagnostics.js";
+export { getNodetoolDataDir, getDefaultDbPath, getDefaultVectorstoreDbPath, getDefaultAssetsPath, getDefaultTransformersJsCacheDir, getAssetFilePath, getAssetDomain, getTempDomain, buildAssetUrl } from "./paths.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,EACL,eAAe,EACf,MAAM,EACN,UAAU,EACV,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,eAAe,EACf,WAAW,EACX,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,MAAM,EACZ,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,2BAA2B,EAC3B,oBAAoB,EACpB,gCAAgC,EAChC,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,aAAa,EACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { loadEnvironment, getEnv, requireEnv, resetEnvironment } from "./environment.js";
+export { registerSetting, getSettings, clearSettings } from "./settings.js";
+export { configureLogging, getLogLevel, createLogger } from "./logging.js";
+export { diagnoseEnvironment, maskSecret } from "./diagnostics.js";
+export { getNodetoolDataDir, getDefaultDbPath, getDefaultVectorstoreDbPath, getDefaultAssetsPath, getDefaultTransformersJsCacheDir, getAssetFilePath, getAssetDomain, getTempDomain, buildAssetUrl } from "./paths.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,EACL,eAAe,EACf,MAAM,EACN,UAAU,EACV,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,eAAe,EACf,WAAW,EACX,aAAa,EAGd,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,YAAY,EAIb,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,mBAAmB,EACnB,UAAU,EAEX,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,2BAA2B,EAC3B,oBAAoB,EACpB,gCAAgC,EAChC,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,aAAa,EACd,MAAM,YAAY,CAAC"}

package/dist/logging.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Logging — matches Python's nodetool logging format.
+ *
+ * Usage:
+ *   import { createLogger } from "@nodetool-ai/config";
+ *   const log = createLogger("nodetool.kernel.runner");
+ *   log.info("Workflow started", { jobId });
+ *   log.debug("Node executing", { nodeId, type });
+ */
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export interface Logger {
+    debug(msg: string, ...args: unknown[]): void;
+    info(msg: string, ...args: unknown[]): void;
+    warn(msg: string, ...args: unknown[]): void;
+    error(msg: string, ...args: unknown[]): void;
+}
+export interface LoggingOptions {
+    level?: LogLevel;
+}
+/**
+ * Configure the global log level.
+ * Priority: explicit option > NODETOOL_LOG_LEVEL env > LOG_LEVEL env > "info"
+ *
+ * If NODETOOL_LOG_FILE is set, logs are written to that file instead of stderr.
+ * This is useful when the terminal is controlled by a TUI (e.g. Ink).
+ */
+export declare function configureLogging(opts?: LoggingOptions): void;
+/** Get the current global log level. */
+export declare function getLogLevel(): LogLevel;
+/**
+ * Create a named logger. Mirrors Python's logging.getLogger(__name__).
+ *
+ * @param name  Module/component name, e.g. "nodetool.kernel.runner"
+ */
+export declare function createLogger(name: string): Logger;
+//# sourceMappingURL=logging.d.ts.map

package/dist/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC7C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAeD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,cAAmB,GAAG,IAAI,CAqBhE;AAED,wCAAwC;AACxC,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAqFD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOjD"}

package/dist/logging.js

@@ -0,0 +1,140 @@
+/**
+ * Logging — matches Python's nodetool logging format.
+ *
+ * Usage:
+ *   import { createLogger } from "@nodetool-ai/config";
+ *   const log = createLogger("nodetool.kernel.runner");
+ *   log.info("Workflow started", { jobId });
+ *   log.debug("Node executing", { nodeId, type });
+ */
+import { openSync, writeSync } from "node:fs";
+const VALID_LEVELS = ["debug", "info", "warn", "error"];
+const LEVEL_NUM = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3
+};
+let currentLevel = "info";
+/** File descriptor for log output. Defaults to stderr; set via NODETOOL_LOG_FILE. */
+let logFd = null;
+/**
+ * Configure the global log level.
+ * Priority: explicit option > NODETOOL_LOG_LEVEL env > LOG_LEVEL env > "info"
+ *
+ * If NODETOOL_LOG_FILE is set, logs are written to that file instead of stderr.
+ * This is useful when the terminal is controlled by a TUI (e.g. Ink).
+ */
+export function configureLogging(opts = {}) {
+    if (opts.level) {
+        currentLevel = opts.level;
+    }
+    else {
+        const envLevel = (process.env["NODETOOL_LOG_LEVEL"] ??
+            process.env["LOG_LEVEL"] ??
+            "info").toLowerCase();
+        currentLevel = VALID_LEVELS.includes(envLevel) ? envLevel : "info";
+    }
+    // Open log file if configured (lazy import to keep module lightweight)
+    const logFile = process.env["NODETOOL_LOG_FILE"];
+    if (logFile && logFd === null) {
+        try {
+            logFd = openSync(logFile, "a");
+        }
+        catch {
+            // Fall back to stderr silently
+        }
+    }
+}
+/** Get the current global log level. */
+export function getLogLevel() {
+    return currentLevel;
+}
+// Colour support
+const USE_COLOR = process.stderr.isTTY && !process.env["NO_COLOR"];
+const C = {
+    reset: USE_COLOR ? "\x1b[0m" : "",
+    dim: USE_COLOR ? "\x1b[2m" : "",
+    gray: USE_COLOR ? "\x1b[90m" : "",
+    green: USE_COLOR ? "\x1b[32m" : "",
+    yellow: USE_COLOR ? "\x1b[33m" : "",
+    red: USE_COLOR ? "\x1b[31m" : "",
+    cyan: USE_COLOR ? "\x1b[36m" : ""
+};
+const LEVEL_COLOR = {
+    debug: C.gray,
+    info: C.green,
+    warn: C.yellow,
+    error: C.red
+};
+function timestamp() {
+    const d = new Date();
+    const hh = String(d.getHours()).padStart(2, "0");
+    const mm = String(d.getMinutes()).padStart(2, "0");
+    const ss = String(d.getSeconds()).padStart(2, "0");
+    return `${hh}:${mm}:${ss}`;
+}
+// JSON.stringify replacer that unwraps Error instances — their own fields
+// (`message`, `stack`, `name`) are non-enumerable, so the default serializer
+// produces "{}". Without this, nested errors like `{ provider, error }` lose
+// all diagnostic information in the log output.
+function jsonReplacer(_key, value) {
+    if (value instanceof Error) {
+        return {
+            name: value.name,
+            message: value.message,
+            ...(value.stack ? { stack: value.stack } : {}),
+            ...(value.cause !== undefined ? { cause: value.cause } : {})
+        };
+    }
+    return value;
+}
+function formatArgs(args) {
+    if (args.length === 0)
+        return "";
+    return (" " +
+        args
+            .map((a) => {
+            if (a instanceof Error)
+                return a.stack ?? a.message;
+            if (typeof a === "object" && a !== null) {
+                try {
+                    return JSON.stringify(a, jsonReplacer);
+                }
+                catch {
+                    return String(a);
+                }
+            }
+            return String(a);
+        })
+            .join(" "));
+}
+function write(level, name, msg, args) {
+    if (LEVEL_NUM[level] < LEVEL_NUM[currentLevel])
+        return;
+    const lc = LEVEL_COLOR[level];
+    const ts = `${C.dim}${timestamp()}${C.reset}`;
+    const lv = `${lc}${level.toUpperCase().padEnd(5)}${C.reset}`;
+    const nm = `${C.cyan}${name}${C.reset}`;
+    const line = `${ts} | ${lv} | ${nm} | ${msg}${formatArgs(args)}\n`;
+    if (logFd !== null) {
+        writeSync(logFd, line);
+    }
+    else {
+        process.stderr.write(line);
+    }
+}
+/**
+ * Create a named logger. Mirrors Python's logging.getLogger(__name__).
+ *
+ * @param name  Module/component name, e.g. "nodetool.kernel.runner"
+ */
+export function createLogger(name) {
+    return {
+        debug: (msg, ...args) => write("debug", name, msg, args),
+        info: (msg, ...args) => write("info", name, msg, args),
+        warn: (msg, ...args) => write("warn", name, msg, args),
+        error: (msg, ...args) => write("error", name, msg, args)
+    };
+}
+//# sourceMappingURL=logging.js.map

package/dist/logging.js.map

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

package/dist/paths.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Platform-aware paths for Nodetool data files.
+ *
+ * Single source of truth for default file locations so callers don't need to
+ * re-implement OS detection or XDG logic.
+ *
+ * Priority: explicit env var > platform default.
+ */
+/**
+ * Base directory for all Nodetool user data.
+ *
+ * Must match Python's get_system_data_path() in nodetool-core so both
+ * runtimes read/write the same database and assets.
+ *
+ * - Windows:  %APPDATA%\nodetool          (e.g. C:\Users\<name>\AppData\Roaming\nodetool)
+ * - macOS/Linux: $XDG_DATA_HOME/nodetool  (fallback: ~/.local/share/nodetool)
+ */
+export declare function getNodetoolDataDir(): string;
+/** Default path for the main SQLite database. Override with DB_PATH. */
+export declare function getDefaultDbPath(): string;
+/** Default path for the vector store database. Override with VECTORSTORE_DB_PATH. */
+export declare function getDefaultVectorstoreDbPath(): string;
+/** Default path for local asset storage. Override with ASSET_FOLDER or STORAGE_PATH. */
+export declare function getDefaultAssetsPath(): string;
+/**
+ * Default cache directory for the `@huggingface/transformers` (Transformers.js)
+ * runtime. Override with TRANSFORMERS_JS_CACHE_DIR.
+ *
+ * Transformers.js uses its own flat layout (`{cacheDir}/{repo_id}/{file_path}`)
+ * which is incompatible with the Python `huggingface_hub` cache, so we keep it
+ * under the Nodetool data directory rather than alongside `~/.cache/huggingface`.
+ */
+export declare function getDefaultTransformersJsCacheDir(): string;
+/**
+ * Public domain for permanent assets (set via ASSET_DOMAIN env var).
+ *
+ * When set, asset URLs are built as `https://<domain>/<key>` instead of
+ * `/api/storage/<key>`. Accepts bare hostnames (`assets.nodetool.ai`) or
+ * full origins (`https://assets.nodetool.ai`). Returns `undefined` when not
+ * configured.
+ */
+export declare function getAssetDomain(): string | undefined;
+/**
+ * Public domain for temporary assets (set via TEMP_DOMAIN env var).
+ *
+ * Applied to keys with the `temp/` prefix. Accepts bare hostnames or full
+ * origins. Returns `undefined` when not configured, in which case temp URLs
+ * fall back to `ASSET_DOMAIN` (if set) or the `/api/storage/` path.
+ */
+export declare function getTempDomain(): string | undefined;
+/**
+ * Return the absolute filesystem path for a storage key.
+ *
+ * Use this on the server side whenever you need to read an asset from disk.
+ * Never pass the result to a browser client — use `buildAssetUrl` for that.
+ */
+export declare function getAssetFilePath(key: string): string;
+/**
+ * Build a **client-facing** URL for an asset identified by its storage key.
+ *
+ * The key is the storage-relative path (e.g. `abc.png` or `temp/uuid.png`).
+ * When ASSET_DOMAIN / TEMP_DOMAIN are configured, returns an absolute CDN URL.
+ * Otherwise returns `/api/storage/<key>` — a dev-mode path that the browser
+ * can reach via the Vite proxy or the local HTTP server.
+ *
+ * Do NOT use this for server-side file reads. Use `getAssetFilePath` instead.
+ */
+export declare function buildAssetUrl(key: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAY3C;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,IAAI,MAAM,CAIzC;AAED,qFAAqF;AACrF,wBAAgB,2BAA2B,IAAI,MAAM,CAKpD;AAED,wFAAwF;AACxF,wBAAgB,oBAAoB,IAAI,MAAM,CAM7C;AAED;;;;;;;GAOG;AACH,wBAAgB,gCAAgC,IAAI,MAAM,CAKzD;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,MAAM,GAAG,SAAS,CAGnD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,MAAM,GAAG,SAAS,CAGlD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAoBjD"}

package/dist/paths.js

@@ -0,0 +1,114 @@
+/**
+ * Platform-aware paths for Nodetool data files.
+ *
+ * Single source of truth for default file locations so callers don't need to
+ * re-implement OS detection or XDG logic.
+ *
+ * Priority: explicit env var > platform default.
+ */
+import { join } from "node:path";
+import { homedir } from "node:os";
+/**
+ * Base directory for all Nodetool user data.
+ *
+ * Must match Python's get_system_data_path() in nodetool-core so both
+ * runtimes read/write the same database and assets.
+ *
+ * - Windows:  %APPDATA%\nodetool          (e.g. C:\Users\<name>\AppData\Roaming\nodetool)
+ * - macOS/Linux: $XDG_DATA_HOME/nodetool  (fallback: ~/.local/share/nodetool)
+ */
+export function getNodetoolDataDir() {
+    if (process.platform === "win32") {
+        return join(process.env["APPDATA"] ?? join(homedir(), "AppData", "Roaming"), "nodetool");
+    }
+    // macOS and Linux: use XDG standard to match Python side
+    return join(process.env["XDG_DATA_HOME"] ?? join(homedir(), ".local", "share"), "nodetool");
+}
+/** Default path for the main SQLite database. Override with DB_PATH. */
+export function getDefaultDbPath() {
+    return (process.env["DB_PATH"] ?? join(getNodetoolDataDir(), "nodetool.sqlite3"));
+}
+/** Default path for the vector store database. Override with VECTORSTORE_DB_PATH. */
+export function getDefaultVectorstoreDbPath() {
+    return (process.env["VECTORSTORE_DB_PATH"] ??
+        join(getNodetoolDataDir(), "vectorstore.db"));
+}
+/** Default path for local asset storage. Override with ASSET_FOLDER or STORAGE_PATH. */
+export function getDefaultAssetsPath() {
+    return (process.env["ASSET_FOLDER"] ??
+        process.env["STORAGE_PATH"] ??
+        join(getNodetoolDataDir(), "assets"));
+}
+/**
+ * Default cache directory for the `@huggingface/transformers` (Transformers.js)
+ * runtime. Override with TRANSFORMERS_JS_CACHE_DIR.
+ *
+ * Transformers.js uses its own flat layout (`{cacheDir}/{repo_id}/{file_path}`)
+ * which is incompatible with the Python `huggingface_hub` cache, so we keep it
+ * under the Nodetool data directory rather than alongside `~/.cache/huggingface`.
+ */
+export function getDefaultTransformersJsCacheDir() {
+    return (process.env["TRANSFORMERS_JS_CACHE_DIR"] ??
+        join(getNodetoolDataDir(), "transformers-js-cache"));
+}
+/**
+ * Public domain for permanent assets (set via ASSET_DOMAIN env var).
+ *
+ * When set, asset URLs are built as `https://<domain>/<key>` instead of
+ * `/api/storage/<key>`. Accepts bare hostnames (`assets.nodetool.ai`) or
+ * full origins (`https://assets.nodetool.ai`). Returns `undefined` when not
+ * configured.
+ */
+export function getAssetDomain() {
+    const value = process.env["ASSET_DOMAIN"];
+    return value && value.trim() !== "" ? value.trim() : undefined;
+}
+/**
+ * Public domain for temporary assets (set via TEMP_DOMAIN env var).
+ *
+ * Applied to keys with the `temp/` prefix. Accepts bare hostnames or full
+ * origins. Returns `undefined` when not configured, in which case temp URLs
+ * fall back to `ASSET_DOMAIN` (if set) or the `/api/storage/` path.
+ */
+export function getTempDomain() {
+    const value = process.env["TEMP_DOMAIN"];
+    return value && value.trim() !== "" ? value.trim() : undefined;
+}
+/**
+ * Return the absolute filesystem path for a storage key.
+ *
+ * Use this on the server side whenever you need to read an asset from disk.
+ * Never pass the result to a browser client — use `buildAssetUrl` for that.
+ */
+export function getAssetFilePath(key) {
+    return join(getDefaultAssetsPath(), key.replace(/^\/+/, ""));
+}
+/**
+ * Build a **client-facing** URL for an asset identified by its storage key.
+ *
+ * The key is the storage-relative path (e.g. `abc.png` or `temp/uuid.png`).
+ * When ASSET_DOMAIN / TEMP_DOMAIN are configured, returns an absolute CDN URL.
+ * Otherwise returns `/api/storage/<key>` — a dev-mode path that the browser
+ * can reach via the Vite proxy or the local HTTP server.
+ *
+ * Do NOT use this for server-side file reads. Use `getAssetFilePath` instead.
+ */
+export function buildAssetUrl(key) {
+    const normalized = key.replace(/^\/+/, "");
+    const isTemp = normalized.startsWith("temp/");
+    const domain = isTemp
+        ? (getTempDomain() ?? getAssetDomain())
+        : getAssetDomain();
+    if (!domain) {
+        return `/api/storage/${normalized}`;
+    }
+    const origin = /^https?:\/\//i.test(domain) ? domain : `https://${domain}`;
+    const trimmedOrigin = origin.replace(/\/+$/, "");
+    // When serving from a dedicated temp domain, the `temp/` prefix is
+    // redundant — the domain itself identifies the bucket.
+    const path = isTemp && getTempDomain() !== undefined
+        ? normalized.slice("temp/".length)
+        : normalized;
+    return `${trimmedOrigin}/${path}`;
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

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

package/dist/settings.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Settings registry — T-CFG-2.
+ *
+ * Registers configuration settings and reports their configured status.
+ */
+export interface SettingDefinition {
+    package: string;
+    envVar: string;
+    group: string;
+    description: string;
+    isSecret: boolean;
+}
+export interface SettingStatus extends SettingDefinition {
+    configured: boolean;
+}
+/**
+ * Register a configuration setting.
+ */
+export declare function registerSetting(definition: SettingDefinition): void;
+/**
+ * Get all registered settings with their configured status.
+ * A setting is configured if its env var has a non-empty value.
+ */
+export declare function getSettings(): SettingStatus[];
+/**
+ * Clear all registered settings (for testing).
+ */
+export declare function clearSettings(): void;
+//# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,UAAU,EAAE,OAAO,CAAC;CACrB;AAID;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAEnE;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,aAAa,EAAE,CAK7C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAEpC"}

package/dist/settings.js

@@ -0,0 +1,29 @@
+/**
+ * Settings registry — T-CFG-2.
+ *
+ * Registers configuration settings and reports their configured status.
+ */
+const registry = new Map();
+/**
+ * Register a configuration setting.
+ */
+export function registerSetting(definition) {
+    registry.set(definition.envVar, definition);
+}
+/**
+ * Get all registered settings with their configured status.
+ * A setting is configured if its env var has a non-empty value.
+ */
+export function getSettings() {
+    return Array.from(registry.values()).map((def) => ({
+        ...def,
+        configured: !!process.env[def.envVar]
+    }));
+}
+/**
+ * Clear all registered settings (for testing).
+ */
+export function clearSettings() {
+    registry.clear();
+}
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;AAEtD;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,UAA6B;IAC3D,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACjD,GAAG,GAAG;QACN,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;KACtC,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@nodetool-ai/config",
+  "version": "0.7.0-rc.11",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "node ../../scripts/build-typescript-workspace.mjs",
+    "test": "vitest run",
+    "lint": "tsc --noEmit"
+  },
+  "dependencies": {
+    "dotenv": "^16.4.0"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.2",
+    "typescript": "^5.7.2"
+  },
+  "exports": {
+    ".": {
+      "nodetool-dev": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nodetool-ai/nodetool.git",
+    "directory": "packages/config"
+  },
+  "homepage": "https://nodetool.ai",
+  "bugs": {
+    "url": "https://github.com/nodetool-ai/nodetool/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}