agents-library 0.1.0 → 0.1.2

package/dist/utils/config.js

@@ -0,0 +1,163 @@
+/**
+ * Shared TOML config loader for KĀDI agents.
+ *
+ * Loads non-secret configuration from `config.toml` and injects into
+ * `process.env` (existing env vars take precedence).
+ *
+ * Walk-up discovery: searches from CWD upward until it finds config.toml.
+ *
+ * Professor's paradigm:
+ *   secrets.toml  → encrypted vault (committed)
+ *   config.toml   → non-secret settings (committed)
+ *   .env          → optional local override (NOT committed)
+ *
+ * Resolution order: process.env > .env (dotenv) > config.toml > defaults
+ *
+ * @module utils/config
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve, dirname, join } from 'node:path';
+// ── Constants ────────────────────────────────────────────────────────
+const CONFIG_FILENAME = 'config.toml';
+const TAG = '[config]';
+// ── TOML key → env var mapping ───────────────────────────────────────
+//
+// Flat mapping from TOML dotted paths to env var names.
+// Only mapped keys are injected into process.env.
+const TOML_TO_ENV = {
+    'broker.url': 'KADI_BROKER_URL',
+    'broker.networks': 'KADI_NETWORK',
+    'broker.remote.url': 'KADI_BROKER_URL_2',
+    'broker.remote.networks': 'KADI_NETWORK_2',
+    'bot.tool_timeout_ms': 'BOT_TOOL_TIMEOUT_MS',
+    'bot.slack.enabled': 'ENABLE_SLACK_BOT',
+    'bot.slack.user_id': 'SLACK_BOT_USER_ID',
+    'bot.discord.enabled': 'ENABLE_DISCORD_BOT',
+    'bot.discord.user_id': 'DISCORD_BOT_USER_ID',
+    'memory.data_path': 'MEMORY_DATA_PATH',
+};
+// ── Walk-up discovery ────────────────────────────────────────────────
+/**
+ * Walk up from `startDir` to filesystem root looking for config.toml.
+ */
+export function findConfigFile(startDir) {
+    let dir = resolve(startDir);
+    while (true) {
+        const candidate = join(dir, CONFIG_FILENAME);
+        if (existsSync(candidate))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break; // reached root
+        dir = parent;
+    }
+    return null;
+}
+export function parseSimpleToml(content) {
+    const result = {};
+    let currentSection = '';
+    for (const rawLine of content.split('\n')) {
+        const line = rawLine.trim();
+        // Skip comments and blank lines
+        if (!line || line.startsWith('#'))
+            continue;
+        // Section header: [broker] or [broker.remote]
+        const sectionMatch = line.match(/^\[([a-zA-Z0-9._-]+)\]$/);
+        if (sectionMatch) {
+            currentSection = sectionMatch[1];
+            continue;
+        }
+        // Key = value
+        const kvMatch = line.match(/^([a-zA-Z0-9_-]+)\s*=\s*(.+)$/);
+        if (!kvMatch)
+            continue;
+        const key = kvMatch[1];
+        const rawValue = kvMatch[2].trim();
+        const fullKey = currentSection ? `${currentSection}.${key}` : key;
+        // Parse value
+        result[fullKey] = parseTomlValue(rawValue);
+    }
+    return result;
+}
+function parseTomlValue(raw) {
+    // Boolean
+    if (raw === 'true')
+        return true;
+    if (raw === 'false')
+        return false;
+    // Number (integer or float)
+    if (/^-?\d+(\.\d+)?$/.test(raw))
+        return Number(raw);
+    // String (quoted)
+    if ((raw.startsWith('"') && raw.endsWith('"')) ||
+        (raw.startsWith("'") && raw.endsWith("'"))) {
+        return raw.slice(1, -1);
+    }
+    // Array of strings: ["a", "b", "c"]
+    if (raw.startsWith('[') && raw.endsWith(']')) {
+        const inner = raw.slice(1, -1).trim();
+        if (!inner)
+            return [];
+        return inner.split(',').map(s => {
+            const trimmed = s.trim();
+            if ((trimmed.startsWith('"') && trimmed.endsWith('"')) ||
+                (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+                return trimmed.slice(1, -1);
+            }
+            return trimmed;
+        });
+    }
+    // Bare string (unquoted)
+    return raw;
+}
+// ── Public API ───────────────────────────────────────────────────────
+/**
+ * Load config.toml and inject mapped values into process.env.
+ *
+ * - Walks up from `startDir` (default: CWD) to find config.toml
+ * - Only injects keys defined in TOML_TO_ENV mapping
+ * - Existing env vars are NOT overwritten (env > config.toml)
+ * - Array values are joined with commas (e.g. networks)
+ *
+ * @param startDir - Directory to start searching from (default: process.cwd())
+ * @returns Info about what was loaded
+ */
+export function loadConfig(startDir) {
+    const configPath = findConfigFile(startDir || process.cwd());
+    if (!configPath) {
+        return { configPath: null, injectedCount: 0 };
+    }
+    const content = readFileSync(configPath, 'utf-8');
+    const parsed = parseSimpleToml(content);
+    let injectedCount = 0;
+    for (const [tomlKey, envKey] of Object.entries(TOML_TO_ENV)) {
+        // Skip if env var already set (env takes precedence)
+        if (process.env[envKey])
+            continue;
+        const value = parsed[tomlKey];
+        if (value === undefined || value === null)
+            continue;
+        // Convert to string for process.env
+        if (Array.isArray(value)) {
+            process.env[envKey] = value.join(',');
+        }
+        else {
+            process.env[envKey] = String(value);
+        }
+        injectedCount++;
+    }
+    if (injectedCount > 0) {
+        console.log(`${TAG} Loaded ${injectedCount} settings from ${configPath}`);
+    }
+    return { configPath, injectedCount };
+}
+/**
+ * Register additional TOML key → env var mappings.
+ *
+ * Allows agents to extend the default mapping with agent-specific keys
+ * before calling loadConfig().
+ */
+export function registerConfigMapping(mappings) {
+    Object.assign(TOML_TO_ENV, mappings);
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

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

package/dist/utils/logger.d.ts

@@ -20,15 +20,25 @@
  *
  * @module logger
  */
+/**
+ * Set the minimum log level. Messages below this level are suppressed.
+ * Hierarchy: debug < info < warn < error
+ */
+export declare function setLogLevel(level: string): void;
 /**
  * Module name constants for structured logging
  * All use kebab-case for consistency with KĀDI naming conventions
  */
-export declare const MODULE_AGENT: "template-agent";
+export declare let MODULE_AGENT: string;
 export declare const MODULE_SLACK_BOT: "slack-bot";
 export declare const MODULE_DISCORD_BOT: "discord-bot";
 export declare const MODULE_TASK_HANDLER: "task-handler";
 export declare const MODULE_TOOLS: "tools";
+/**
+ * Set the MODULE_AGENT tag to the agent's ID.
+ * Call once at startup so all files importing MODULE_AGENT get the right name.
+ */
+export declare function setAgentTag(name: string): void;
 /**
  * UnrealLogger class for Unreal Engine-style structured logging
  *

package/dist/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAG,gBAAyB,CAAC;AACtD,eAAO,MAAM,gBAAgB,EAAG,WAAoB,CAAC;AACrD,eAAO,MAAM,kBAAkB,EAAG,aAAsB,CAAC;AACzD,eAAO,MAAM,mBAAmB,EAAG,cAAuB,CAAC;AAC3D,eAAO,MAAM,YAAY,EAAG,OAAgB,CAAC;AAoB7C;;;;;;;;;;;GAWG;AACH,cAAM,MAAM;IACR;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAUpB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,eAAe;IAIvB;;;;;;;;;OASG;IACH,OAAO,CAAC,aAAa;IAkBrB;;;;;;;;;OASG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAO5E;;;;;;;;;OASG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAO5E;;;;;;;;;;OAUG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAkBrG;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;CAMhF;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,MAAM,QAAe,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAOH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED;;;GAGG;AACH,eAAO,IAAI,YAAY,EAAuB,MAAM,CAAC;AACrD,eAAO,MAAM,gBAAgB,EAAG,WAAoB,CAAC;AACrD,eAAO,MAAM,kBAAkB,EAAG,aAAsB,CAAC;AACzD,eAAO,MAAM,mBAAmB,EAAG,cAAuB,CAAC;AAC3D,eAAO,MAAM,YAAY,EAAG,OAAgB,CAAC;AAE7C;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE9C;AAoBD;;;;;;;;;;;GAWG;AACH,cAAM,MAAM;IACR;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAUpB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,eAAe;IAIvB;;;;;;;;;OASG;IACH,OAAO,CAAC,aAAa;IAkBrB;;;;;;;;;OASG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAQ5E;;;;;;;;;OASG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAQ5E;;;;;;;;;;OAUG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAmBrG;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;CAOhF;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/utils/logger.js

@@ -20,15 +20,32 @@
  *
  * @module logger
  */
+// ── Log level filtering ──────────────────────────────────────────────
+const LEVELS = { debug: 0, info: 1, warn: 2, error: 3 };
+let currentLevel = LEVELS.info;
+/**
+ * Set the minimum log level. Messages below this level are suppressed.
+ * Hierarchy: debug < info < warn < error
+ */
+export function setLogLevel(level) {
+    currentLevel = LEVELS[level.toLowerCase()] ?? LEVELS.info;
+}
 /**
  * Module name constants for structured logging
  * All use kebab-case for consistency with KĀDI naming conventions
  */
-export const MODULE_AGENT = 'template-agent';
+export let MODULE_AGENT = 'template-agent';
 export const MODULE_SLACK_BOT = 'slack-bot';
 export const MODULE_DISCORD_BOT = 'discord-bot';
 export const MODULE_TASK_HANDLER = 'task-handler';
 export const MODULE_TOOLS = 'tools';
+/**
+ * Set the MODULE_AGENT tag to the agent's ID.
+ * Call once at startup so all files importing MODULE_AGENT get the right name.
+ */
+export function setAgentTag(name) {
+    MODULE_AGENT = name;
+}
 /**
  * ANSI Color Codes for Terminal Output
  *
@@ -123,6 +140,8 @@ class Logger {
      * @param data - Optional data to log (will be logged on separate line)
      */
     info(module, message, elapsedTime, data) {
+        if (currentLevel > LEVELS.info)
+            return;
         console.log(this.formatMessage(module, 'Info', message, elapsedTime, COLORS.CYAN));
         if (data) {
             console.log(data);
@@ -139,6 +158,8 @@ class Logger {
      * @param data - Optional data to log
      */
     warn(module, message, elapsedTime, data) {
+        if (currentLevel > LEVELS.warn)
+            return;
         console.warn(this.formatMessage(module, 'Warning', message, elapsedTime, COLORS.YELLOW));
         if (data) {
             console.warn(data);
@@ -156,6 +177,8 @@ class Logger {
      * @param data - Optional additional data to log
      */
     error(module, message, elapsedTime, error, data) {
+        if (currentLevel > LEVELS.error)
+            return;
         console.error(this.formatMessage(module, 'Error', message, elapsedTime, COLORS.RED));
         if (error instanceof Error) {
             if (error.stack) {
@@ -183,6 +206,8 @@ class Logger {
      * @param data - Optional data to log
      */
     debug(module, message, elapsedTime, data) {
+        if (currentLevel > LEVELS.debug)
+            return;
         console.log(this.formatMessage(module, 'Debug', message, elapsedTime, COLORS.GRAY));
         if (data) {
             console.log(data);

package/dist/utils/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,gBAAyB,CAAC;AACtD,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAoB,CAAC;AACrD,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAsB,CAAC;AACzD,MAAM,CAAC,MAAM,mBAAmB,GAAG,cAAuB,CAAC;AAC3D,MAAM,CAAC,MAAM,YAAY,GAAG,OAAgB,CAAC;AAE7C;;;;;;;;GAQG;AACH,MAAM,MAAM,GAAG;IACX,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,UAAU,EAAM,aAAa;IACnC,MAAM,EAAE,UAAU,EAAI,gBAAgB;IACtC,GAAG,EAAE,UAAU,EAAO,cAAc;IACpC,IAAI,EAAE,UAAU,EAAM,cAAc;IACpC,KAAK,EAAE,UAAU,CAAK,qBAAqB;CAC9C,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM;IACR;;;;OAIG;IACK,YAAY;QAChB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC1D,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAEpE,OAAO,GAAG,KAAK,IAAI,OAAO,IAAI,OAAO,IAAI,YAAY,EAAE,CAAC;IAC5D,CAAC;IAED;;;;;;;;;;;OAWG;IACK,eAAe;QACnB,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC;IACtE,CAAC;IAED;;;;;;;;;OASG;IACK,aAAa,CAAC,MAAc,EAAE,KAAa,EAAE,OAAe,EAAE,WAAmB,EAAE,KAAc;QACrG,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAEtC,IAAI,IAAI,CAAC,eAAe,EAAE,IAAI,KAAK,EAAE,CAAC;YAClC,0FAA0F;YAC1F,0GAA0G;YAC1G,+DAA+D;YAC/D,uDAAuD;YACvD,yCAAyC;YACzC,wBAAwB;YACxB,oDAAoD;YACpD,OAAO,GAAG,KAAK,IAAI,MAAM,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,KAAK,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC,KAAK,IAAI,KAAK,GAAG,WAAW,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;QAC/K,CAAC;QAED,sCAAsC;QACtC,OAAO,IAAI,MAAM,MAAM,SAAS,KAAK,KAAK,KAAK,OAAO,IAAI,WAAW,EAAE,CAAC;IAC5E,CAAC;IAED;;;;;;;;;OASG;IACH,IAAI,CAAC,MAAc,EAAE,OAAe,EAAE,WAAmB,EAAE,IAAU;QACjE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACnF,IAAI,IAAI,EAAE,CAAC;YACP,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,IAAI,CAAC,MAAc,EAAE,OAAe,EAAE,WAAmB,EAAE,IAAU;QACjE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACzF,IAAI,IAAI,EAAE,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,MAAc,EAAE,OAAe,EAAE,WAAmB,EAAE,KAAsB,EAAE,IAAU;QAC1F,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAErF,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YACzB,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBACd,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC;iBAAM,CAAC;gBACJ,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACjC,CAAC;QACL,CAAC;aAAM,IAAI,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QAED,IAAI,IAAI,EAAE,CAAC;YACP,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAc,EAAE,OAAe,EAAE,WAAmB,EAAE,IAAU;QAClE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACpF,IAAI,IAAI,EAAE,CAAC;YACP,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACL,CAAC;CACJ;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"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"}

package/dist/utils/path-utils.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Cross-platform path utilities for WSL/Windows interop.
+ *
+ * When git worktrees are created on Windows, the `.git` file stores
+ * Windows-style paths (e.g. `C:/GitHub/...`). If the agent later runs
+ * inside WSL, those paths must be translated to `/mnt/c/GitHub/...`.
+ */
+/**
+ * Detect whether the current process is running inside WSL.
+ * Uses `/proc/version` which contains "microsoft" or "WSL" on WSL distros.
+ */
+export declare function isWsl(): boolean;
+/**
+ * Convert a Windows-style path to a WSL path when running inside WSL.
+ *
+ * `C:/GitHub/foo` → `/mnt/c/GitHub/foo`
+ * `D:\Projects\bar` → `/mnt/d/Projects/bar`
+ *
+ * If not running in WSL, or the path is already POSIX, returns as-is.
+ */
+export declare function toNativePath(p: string): string;
+//# sourceMappingURL=path-utils.d.ts.map

package/dist/utils/path-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.d.ts","sourceRoot":"","sources":["../../src/utils/path-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH;;;GAGG;AACH,wBAAgB,KAAK,IAAI,OAAO,CAgB/B;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAU9C"}

package/dist/utils/path-utils.js

@@ -0,0 +1,51 @@
+/**
+ * Cross-platform path utilities for WSL/Windows interop.
+ *
+ * When git worktrees are created on Windows, the `.git` file stores
+ * Windows-style paths (e.g. `C:/GitHub/...`). If the agent later runs
+ * inside WSL, those paths must be translated to `/mnt/c/GitHub/...`.
+ */
+import os from 'os';
+import fs from 'fs';
+/** Cached result — true when running inside WSL. */
+let _isWsl = null;
+/**
+ * Detect whether the current process is running inside WSL.
+ * Uses `/proc/version` which contains "microsoft" or "WSL" on WSL distros.
+ */
+export function isWsl() {
+    if (_isWsl !== null)
+        return _isWsl;
+    if (os.platform() !== 'linux') {
+        _isWsl = false;
+        return false;
+    }
+    try {
+        const procVersion = fs.readFileSync('/proc/version', 'utf-8').toLowerCase();
+        _isWsl = procVersion.includes('microsoft') || procVersion.includes('wsl');
+    }
+    catch {
+        _isWsl = false;
+    }
+    return _isWsl;
+}
+/**
+ * Convert a Windows-style path to a WSL path when running inside WSL.
+ *
+ * `C:/GitHub/foo` → `/mnt/c/GitHub/foo`
+ * `D:\Projects\bar` → `/mnt/d/Projects/bar`
+ *
+ * If not running in WSL, or the path is already POSIX, returns as-is.
+ */
+export function toNativePath(p) {
+    if (!isWsl())
+        return p;
+    // Match drive letter: C:/ or C:\ (case-insensitive)
+    const match = p.match(/^([A-Za-z]):[/\\](.*)/);
+    if (!match)
+        return p;
+    const drive = match[1].toLowerCase();
+    const rest = match[2].replace(/\\/g, '/');
+    return `/mnt/${drive}/${rest}`;
+}
+//# sourceMappingURL=path-utils.js.map

package/dist/utils/path-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.js","sourceRoot":"","sources":["../../src/utils/path-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,oDAAoD;AACpD,IAAI,MAAM,GAAmB,IAAI,CAAC;AAElC;;;GAGG;AACH,MAAM,UAAU,KAAK;IACnB,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAEnC,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,OAAO,EAAE,CAAC;QAC9B,MAAM,GAAG,KAAK,CAAC;QACf,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QAC5E,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5E,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,KAAK,CAAC;IACjB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,CAAS;IACpC,IAAI,CAAC,KAAK,EAAE;QAAE,OAAO,CAAC,CAAC;IAEvB,oDAAoD;IACpD,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC;IAErB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC1C,OAAO,QAAQ,KAAK,IAAI,IAAI,EAAE,CAAC;AACjC,CAAC"}

package/dist/utils/read-config.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Typed config reader for KĀDI agents.
+ *
+ * Returns a `Config` wrapper around the parsed config.toml with typed
+ * accessors that throw on missing or wrong-type values.
+ *
+ * Usage:
+ *   const cfg = readConfig();
+ *   const url = cfg.string('broker.url');        // throws if missing
+ *   const nets = cfg.strings('broker.networks'); // throws if missing
+ *   if (cfg.has('broker.remote.url')) { ... }    // optional check
+ *
+ * @module utils/read-config
+ */
+export declare class Config {
+    private data;
+    readonly path: string;
+    constructor(data: Record<string, unknown>, path: string);
+    /** Check if a key exists. */
+    has(key: string): boolean;
+    /** Get raw value. Returns undefined if missing. */
+    get(key: string): unknown;
+    /** Get a string value. Throws if missing or wrong type. */
+    string(key: string): string;
+    /** Get a string array. Throws if missing or wrong type. */
+    strings(key: string): string[];
+    /** Get a boolean. Throws if missing or wrong type. */
+    bool(key: string): boolean;
+    /** Get a number. Throws if missing or wrong type. */
+    number(key: string): number;
+    private require;
+}
+/**
+ * Walk up from CWD to find config.toml, parse it, return a Config instance.
+ * Throws if config.toml is not found.
+ */
+export declare function readConfig(startDir?: string): Config;
+/**
+ * Read a specific TOML file by path and return a Config instance.
+ * Unlike readConfig(), this does not walk up directories — it reads the exact file.
+ */
+export declare function readConfigFile(filePath: string): Config;
+//# sourceMappingURL=read-config.d.ts.map

package/dist/utils/read-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-config.d.ts","sourceRoot":"","sources":["../../src/utils/read-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,qBAAa,MAAM;IACjB,OAAO,CAAC,IAAI,CAA0B;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM;IAKvD,6BAA6B;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,mDAAmD;IACnD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,2DAA2D;IAC3D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAU3B,2DAA2D;IAC3D,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAU9B,sDAAsD;IACtD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAU1B,qDAAqD;IACrD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAY3B,OAAO,CAAC,OAAO;CAShB;AAID;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAUpD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIvD"}

package/dist/utils/read-config.js

@@ -0,0 +1,97 @@
+/**
+ * Typed config reader for KĀDI agents.
+ *
+ * Returns a `Config` wrapper around the parsed config.toml with typed
+ * accessors that throw on missing or wrong-type values.
+ *
+ * Usage:
+ *   const cfg = readConfig();
+ *   const url = cfg.string('broker.url');        // throws if missing
+ *   const nets = cfg.strings('broker.networks'); // throws if missing
+ *   if (cfg.has('broker.remote.url')) { ... }    // optional check
+ *
+ * @module utils/read-config
+ */
+import { readFileSync } from 'node:fs';
+import { findConfigFile, parseSimpleToml } from './config.js';
+// ── Config class ─────────────────────────────────────────────────────
+export class Config {
+    data;
+    path;
+    constructor(data, path) {
+        this.data = data;
+        this.path = path;
+    }
+    /** Check if a key exists. */
+    has(key) {
+        return this.data[key] !== undefined;
+    }
+    /** Get raw value. Returns undefined if missing. */
+    get(key) {
+        return this.data[key];
+    }
+    /** Get a string value. Throws if missing or wrong type. */
+    string(key) {
+        const value = this.require(key);
+        if (typeof value !== 'string') {
+            throw new Error(`Config key '${key}' in ${this.path} is ${typeof value}, expected string`);
+        }
+        return value;
+    }
+    /** Get a string array. Throws if missing or wrong type. */
+    strings(key) {
+        const value = this.require(key);
+        if (!Array.isArray(value)) {
+            throw new Error(`Config key '${key}' in ${this.path} is ${typeof value}, expected string[]`);
+        }
+        return value;
+    }
+    /** Get a boolean. Throws if missing or wrong type. */
+    bool(key) {
+        const value = this.require(key);
+        if (typeof value !== 'boolean') {
+            throw new Error(`Config key '${key}' in ${this.path} is ${typeof value}, expected boolean`);
+        }
+        return value;
+    }
+    /** Get a number. Throws if missing or wrong type. */
+    number(key) {
+        const value = this.require(key);
+        if (typeof value !== 'number') {
+            throw new Error(`Config key '${key}' in ${this.path} is ${typeof value}, expected number`);
+        }
+        return value;
+    }
+    // ── Internal ─────────────────────────────────────────────────────
+    require(key) {
+        const value = this.data[key];
+        if (value === undefined) {
+            throw new Error(`Missing required config key '${key}' in ${this.path}`);
+        }
+        return value;
+    }
+}
+// ── Public API ───────────────────────────────────────────────────────
+/**
+ * Walk up from CWD to find config.toml, parse it, return a Config instance.
+ * Throws if config.toml is not found.
+ */
+export function readConfig(startDir) {
+    const configPath = findConfigFile(startDir || process.cwd());
+    if (!configPath) {
+        throw new Error(`config.toml not found. Searched upward from: ${startDir || process.cwd()}`);
+    }
+    const content = readFileSync(configPath, 'utf-8');
+    const data = parseSimpleToml(content);
+    return new Config(data, configPath);
+}
+/**
+ * Read a specific TOML file by path and return a Config instance.
+ * Unlike readConfig(), this does not walk up directories — it reads the exact file.
+ */
+export function readConfigFile(filePath) {
+    const content = readFileSync(filePath, 'utf-8');
+    const data = parseSimpleToml(content);
+    return new Config(data, filePath);
+}
+//# sourceMappingURL=read-config.js.map

package/dist/utils/read-config.js.map

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

package/dist/utils/vault.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Shared vault credential loader for KĀDI agents.
+ *
+ * Loads credentials from one or more vaults specified in config.toml:
+ *   [secrets]
+ *   VAULTS = ["anthropic", "model-manager"]
+ *   KEYS = ["ANTHROPIC_API_KEY", "MODEL_MANAGER_BASE_URL", "MODEL_MANAGER_API_KEY"]
+ *
+ * Falls back to the hardcoded defaults if config.toml is missing or
+ * has no [secrets] section.
+ *
+ * @module utils/vault
+ */
+export type VaultCredentials = Record<string, string>;
+/** @deprecated Use VaultCredentials instead */
+export type ModelManagerCredentials = VaultCredentials;
+/**
+ * Load credentials from configured vaults.
+ *
+ * Reads [secrets] VAULTS and KEYS from config.toml.
+ * For each key, tries each vault in order until found.
+ *
+ * Returns empty object if vault or secret-ability is unavailable
+ * (graceful degradation).
+ */
+export declare function loadVaultCredentials(): Promise<VaultCredentials>;
+/** @deprecated Use loadVaultCredentials instead */
+export declare const loadModelManagerCredentials: typeof loadVaultCredentials;
+//# sourceMappingURL=vault.d.ts.map

package/dist/utils/vault.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault.d.ts","sourceRoot":"","sources":["../../src/utils/vault.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAgBH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEtD,+CAA+C;AAC/C,MAAM,MAAM,uBAAuB,GAAG,gBAAgB,CAAC;AAIvD;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAkDtE;AAED,mDAAmD;AACnD,eAAO,MAAM,2BAA2B,6BAAuB,CAAC"}

package/dist/utils/vault.js

@@ -0,0 +1,79 @@
+/**
+ * Shared vault credential loader for KĀDI agents.
+ *
+ * Loads credentials from one or more vaults specified in config.toml:
+ *   [secrets]
+ *   VAULTS = ["anthropic", "model-manager"]
+ *   KEYS = ["ANTHROPIC_API_KEY", "MODEL_MANAGER_BASE_URL", "MODEL_MANAGER_API_KEY"]
+ *
+ * Falls back to the hardcoded defaults if config.toml is missing or
+ * has no [secrets] section.
+ *
+ * @module utils/vault
+ */
+import { readConfig } from './read-config.js';
+// ── Constants ────────────────────────────────────────────────────────
+const DEFAULT_VAULTS = ['model-manager'];
+const DEFAULT_KEYS = [
+    'MODEL_MANAGER_BASE_URL',
+    'MODEL_MANAGER_API_KEY',
+    'ANTHROPIC_API_KEY',
+];
+const TAG = '[vault]';
+// ── Public API ───────────────────────────────────────────────────────
+/**
+ * Load credentials from configured vaults.
+ *
+ * Reads [secrets] VAULTS and KEYS from config.toml.
+ * For each key, tries each vault in order until found.
+ *
+ * Returns empty object if vault or secret-ability is unavailable
+ * (graceful degradation).
+ */
+export async function loadVaultCredentials() {
+    const credentials = {};
+    // Resolve vault names and keys from config.toml
+    let vaultNames;
+    let vaultKeys;
+    try {
+        const cfg = readConfig();
+        vaultNames = cfg.has('secrets.VAULTS') ? cfg.strings('secrets.VAULTS') : DEFAULT_VAULTS;
+        vaultKeys = cfg.has('secrets.KEYS') ? cfg.strings('secrets.KEYS') : DEFAULT_KEYS;
+    }
+    catch {
+        vaultNames = DEFAULT_VAULTS;
+        vaultKeys = DEFAULT_KEYS;
+    }
+    try {
+        const { KadiClient } = await import('@kadi.build/core');
+        const tmpClient = new KadiClient({ name: 'vault-loader', version: '1.0.0' });
+        const secrets = await tmpClient.loadNative('secret-ability');
+        // For each key, try each vault in order until found
+        for (const key of vaultKeys) {
+            for (const vault of vaultNames) {
+                try {
+                    const result = await secrets.invoke('get', { vault, key });
+                    if (result?.value) {
+                        credentials[key] = result.value;
+                        break; // Found — skip remaining vaults for this key
+                    }
+                }
+                catch {
+                    // Key not in this vault — try next
+                }
+            }
+        }
+        await secrets.disconnect();
+        const loaded = Object.keys(credentials).length;
+        if (loaded > 0) {
+            console.log(`${TAG} Loaded ${loaded}/${vaultKeys.length} credentials from vaults: ${vaultNames.join(', ')}`);
+        }
+    }
+    catch (err) {
+        console.warn(`${TAG} secret-ability unavailable — using env vars only (${err?.message ?? err})`);
+    }
+    return credentials;
+}
+/** @deprecated Use loadVaultCredentials instead */
+export const loadModelManagerCredentials = loadVaultCredentials;
+//# sourceMappingURL=vault.js.map