@tonycasey/lisa 2.0.0 → 2.2.0

package/dist/{project/.lisa → lib}/skills/shared/utils/Logger.js

@@ -6,9 +6,31 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.logger = void 0;
 exports.createLogger = createLogger;
 exports.createConsoleLogger = createConsoleLogger;
-const pino_1 = __importDefault(require("pino"));
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
+// ANSI color codes for console output
+const COLORS = {
+    reset: '\x1b[0m',
+    dim: '\x1b[2m',
+    red: '\x1b[31m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    cyan: '\x1b[36m',
+    gray: '\x1b[90m',
+};
+const LEVEL_COLORS = {
+    DEBUG: COLORS.gray,
+    INFO: COLORS.blue,
+    WARN: COLORS.yellow,
+    ERROR: COLORS.red,
+};
+const LEVEL_PRIORITY = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    silent: 4,
+};
 /**
  * Get the .lisa directory path by traversing up from current file.
  */
@@ -51,6 +73,19 @@ function readEnvFile(envPath) {
     }
     return env;
 }
+/**
+ * Format timestamp as YYYY-MM-DD HH:mm:ss.SSS
+ */
+function formatTimestamp(date) {
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, '0');
+    const day = String(date.getDate()).padStart(2, '0');
+    const hours = String(date.getHours()).padStart(2, '0');
+    const minutes = String(date.getMinutes()).padStart(2, '0');
+    const seconds = String(date.getSeconds()).padStart(2, '0');
+    const ms = String(date.getMilliseconds()).padStart(3, '0');
+    return `${year}-${month}-${day} ${hours}:${minutes}:${seconds}.${ms}`;
+}
 /**
  * Get today's date as YYYY-MM-DD.
  */
@@ -77,7 +112,7 @@ function ensureLogDir(logDir) {
 /**
  * Load logger configuration from environment.
  */
-function loadLoggerConfig(name) {
+function loadLoggerConfig(_name) {
     const lisaDir = getLisaDir();
     const envPath = path_1.default.join(lisaDir, '.env');
     const env = readEnvFile(envPath);
@@ -98,77 +133,92 @@ function loadLoggerConfig(name) {
     };
 }
 /**
- * Creates a pino-based logger instance.
+ * Creates a logger instance with file and optional console output.
  */
 function createLogger(name, config) {
     const loadedConfig = loadLoggerConfig(name);
     const level = config?.level ?? loadedConfig.level;
     const logDir = config?.destination ?? loadedConfig.logDir;
     const enableConsole = config?.prettyPrint ?? loadedConfig.enableConsole;
-    // Build pino transports
-    const targets = [];
-    // Console transport (pretty printing)
-    if (enableConsole) {
-        targets.push({
-            target: 'pino-pretty',
-            options: {
-                colorize: true,
-                translateTime: 'SYS:standard',
-                ignore: 'pid,hostname',
-            },
-            level,
-        });
-    }
-    // File transport
+    // Ensure log directory exists
     ensureLogDir(logDir);
     const logFile = path_1.default.join(logDir, `skills-${getDateString()}.log`);
-    targets.push({
-        target: 'pino/file',
-        options: {
-            destination: logFile,
-            mkdir: true,
-        },
-        level,
-    });
-    const transport = pino_1.default.transport({ targets });
-    const pinoLogger = (0, pino_1.default)({
-        level,
-        timestamp: pino_1.default.stdTimeFunctions.isoTime,
-    }, transport).child({ source: name });
-    return createLoggerFromPino(pinoLogger, name);
-}
-/**
- * Creates an ILogger wrapper around a pino logger.
- */
-function createLoggerFromPino(pinoLogger, source) {
-    return {
-        debug(message, context) {
-            pinoLogger.debug(context ?? {}, message);
-        },
-        info(message, context) {
-            pinoLogger.info(context ?? {}, message);
-        },
-        warn(message, context) {
-            pinoLogger.warn(context ?? {}, message);
-        },
-        error(message, context) {
-            pinoLogger.error(context ?? {}, message);
-        },
-        child(bindings) {
-            const childPino = pinoLogger.child(bindings);
-            return createLoggerFromPino(childPino, source);
-        },
-    };
+    /**
+     * Check if a log level should be output.
+     */
+    function shouldLog(msgLevel) {
+        return LEVEL_PRIORITY[msgLevel] >= LEVEL_PRIORITY[level];
+    }
+    /**
+     * Format context object as compact JSON string.
+     */
+    function formatContext(context) {
+        if (!context || Object.keys(context).length === 0)
+            return '';
+        return ` ${JSON.stringify(context)}`;
+    }
+    /**
+     * Write a log entry.
+     */
+    function writeLog(msgLevel, levelStr, source, message, context) {
+        if (!shouldLog(msgLevel))
+            return;
+        const timestamp = formatTimestamp(new Date());
+        const contextStr = formatContext(context);
+        // File output: plain single-line format
+        const fileLine = `${timestamp} ${levelStr.padEnd(5)} [${source}] ${message}${contextStr}\n`;
+        try {
+            fs_1.default.appendFileSync(logFile, fileLine);
+        }
+        catch {
+            // Silently fail if we can't write to the file
+        }
+        // Console output: colorized
+        if (enableConsole) {
+            const color = LEVEL_COLORS[levelStr] || COLORS.reset;
+            const consoleLine = `${COLORS.dim}${timestamp}${COLORS.reset} ${color}${levelStr.padEnd(5)}${COLORS.reset} ${COLORS.cyan}[${source}]${COLORS.reset} ${message}${COLORS.gray}${contextStr}${COLORS.reset}`;
+            console.error(consoleLine);
+        }
+    }
+    /**
+     * Create logger methods for a specific source.
+     */
+    function createLoggerMethods(source) {
+        return {
+            debug(message, context) {
+                writeLog('debug', 'DEBUG', source, message, context);
+            },
+            info(message, context) {
+                writeLog('info', 'INFO', source, message, context);
+            },
+            warn(message, context) {
+                writeLog('warn', 'WARN', source, message, context);
+            },
+            error(message, context) {
+                writeLog('error', 'ERROR', source, message, context);
+            },
+            child(bindings) {
+                const childSource = bindings.source
+                    ? `${source}:${String(bindings.source)}`
+                    : source;
+                return createLoggerMethods(childSource);
+            },
+        };
+    }
+    return createLoggerMethods(name);
 }
 /**
  * Creates a simple console logger (no file output).
- * Useful for testing or when pino is not available.
+ * Useful for testing or when file logging is not needed.
  */
 function createConsoleLogger(name) {
-    const prefix = `[${name}]`;
     function log(level, message, context) {
-        const contextStr = context ? ` ${JSON.stringify(context)}` : '';
-        console.error(`${new Date().toISOString()} ${level} ${prefix} ${message}${contextStr}`);
+        const timestamp = formatTimestamp(new Date());
+        const contextStr = context && Object.keys(context).length > 0
+            ? ` ${JSON.stringify(context)}`
+            : '';
+        const color = LEVEL_COLORS[level] || COLORS.reset;
+        console.error(`${COLORS.dim}${timestamp}${COLORS.reset} ${color}${level.padEnd(5)}${COLORS.reset} ${COLORS.cyan}[${name}]${COLORS.reset} ${message}${COLORS.gray}${contextStr}${COLORS.reset}`);
     }
     const logger = {
         debug(message, context) {
@@ -185,7 +235,7 @@ function createConsoleLogger(name) {
         },
         child(bindings) {
             const childName = bindings.source
-                ? `${name}:${bindings.source}`
+                ? `${name}:${String(bindings.source)}`
                 : name;
             return createConsoleLogger(childName);
         },

package/dist/lib/skills/shared/utils/Logger.js.map

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

package/dist/lib/skills/shared/utils/cache.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Cache interface for skill scripts.
+ */
+export interface ICache {
+    /**
+     * Write a result to cache.
+     * @param data - Data to cache
+     */
+    write(data: Record<string, unknown>): void;
+    /**
+     * Read the last cached entry as fallback.
+     * @returns Last cached entry or null if not available
+     */
+    readFallback(): Record<string, unknown> | null;
+}
+/**
+ * Configuration for creating a cache instance.
+ */
+export interface ICacheConfig {
+    /** Directory containing the cache file */
+    cacheDir: string;
+    /** Cache filename (e.g., 'tasks.log', 'memory.log') */
+    filename: string;
+}
+/**
+ * Creates a file-based cache instance.
+ *
+ * @param config - Cache configuration
+ * @returns Cache instance
+ */
+export declare function createCache(config: ICacheConfig): ICache;
+/**
+ * Creates a cache config for a skill script.
+ * Cache files are stored in the skill's cache/ directory.
+ *
+ * @param scriptDir - __dirname of the script (e.g., tasks/scripts/)
+ * @param filename - Cache filename (e.g., 'tasks.log')
+ * @returns Cache configuration
+ */
+export declare function createCacheConfig(scriptDir: string, filename: string): ICacheConfig;
+/**
+ * No-op cache implementation for when caching is disabled.
+ */
+export declare const nullCache: ICache;
+//# sourceMappingURL=cache.d.ts.map

package/dist/lib/skills/shared/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../../../src/lib/skills/shared/utils/cache.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE3C;;;OAGG;IACH,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA6BxD;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAYnF;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,MAOvB,CAAC"}

package/dist/{project/.lisa → lib}/skills/shared/utils/cache.js

@@ -57,6 +57,13 @@ function createCache(config) {
  * @returns Cache configuration
  */
 function createCacheConfig(scriptDir, filename) {
+    const envCacheDir = process.env.LISA_SKILL_CACHE_DIR || process.env.LISA_CACHE_DIR;
+    if (envCacheDir) {
+        return {
+            cacheDir: path_1.default.resolve(envCacheDir),
+            filename,
+        };
+    }
     return {
         cacheDir: path_1.default.join(scriptDir, '..', 'cache'),
         filename,

package/dist/lib/skills/shared/utils/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../../../src/lib/skills/shared/utils/cache.ts"],"names":[],"mappings":";;;;;;AAwCA,kCA6BC;AAUD,8CAYC;AA3FD;;;GAGG;AACH,4CAAoB;AACpB,gDAAwB;AA6BxB;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,MAAoB;IAC9C,MAAM,SAAS,GAAG,cAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE9D,OAAO;QACL,KAAK,CAAC,IAA6B;YACjC,IAAI,CAAC;gBACH,gCAAgC;gBAChC,MAAM,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBACpC,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACxB,YAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBACzC,CAAC;gBAED,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;gBACvE,YAAE,CAAC,cAAc,CAAC,SAAS,EAAE,GAAG,IAAI,IAAI,EAAE,MAAM,CAAC,CAAC;YACpD,CAAC;YAAC,MAAM,CAAC;gBACP,gDAAgD;YAClD,CAAC;QACH,CAAC;QAED,YAAY;YACV,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,YAAE,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACnF,IAAI,CAAC,IAAI,CAAC,MAAM;oBAAE,OAAO,IAAI,CAAC;gBAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAA4B,CAAC;YACtE,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,iBAAiB,CAAC,SAAiB,EAAE,QAAgB;IACnE,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IACnF,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO;YACL,QAAQ,EAAE,cAAI,CAAC,OAAO,CAAC,WAAW,CAAC;YACnC,QAAQ;SACT,CAAC;IACJ,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC;QAC7C,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;GAEG;AACU,QAAA,SAAS,GAAW;IAC/B,KAAK;QACH,QAAQ;IACV,CAAC;IACD,YAAY;QACV,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC"}

package/dist/lib/skills/shared/utils/cli.d.ts

@@ -0,0 +1,60 @@
+/**
+ * CLI argument parsing utilities.
+ * Provides functions for parsing command-line arguments in skill scripts.
+ */
+/**
+ * Parsed CLI arguments structure.
+ */
+export interface IParsedArgs {
+    /** The command (first positional argument) */
+    command: string;
+    /** Remaining positional arguments joined as payload */
+    payload: string;
+    /** Named flags (--flag value or --flag) */
+    flags: Map<string, string | true>;
+}
+/**
+ * Pop a flag from the args array and return its value.
+ * Mutates the args array by removing the flag and its value.
+ *
+ * @param args - The arguments array to modify
+ * @param name - The flag name (e.g., '--group')
+ * @param fallback - Default value if flag not found
+ * @returns The flag value or fallback
+ */
+export declare function popFlag(args: string[], name: string, fallback: string): string;
+export declare function popFlag(args: string[], name: string, fallback: null): string | null;
+/**
+ * Check if a boolean flag is present and remove it from args.
+ * Mutates the args array by removing the flag.
+ *
+ * @param args - The arguments array to modify
+ * @param name - The flag name (e.g., '--cache')
+ * @returns True if flag was present
+ */
+export declare function hasFlag(args: string[], name: string): boolean;
+/**
+ * Parse all arguments into a structured format.
+ * Does not mutate the input array.
+ *
+ * @param argv - Raw arguments (typically process.argv.slice(2))
+ * @returns Parsed arguments structure
+ */
+export declare function parseArgs(argv: string[]): IParsedArgs;
+/**
+ * Get a string flag value from parsed args.
+ *
+ * @param flags - The flags map from parseArgs
+ * @param name - The flag name (e.g., '--group')
+ * @param fallback - Default value if not found
+ */
+export declare function getFlag(flags: Map<string, string | true>, name: string, fallback: string): string;
+export declare function getFlag(flags: Map<string, string | true>, name: string, fallback: null): string | null;
+/**
+ * Check if a boolean flag is set in parsed args.
+ *
+ * @param flags - The flags map from parseArgs
+ * @param name - The flag name (e.g., '--cache')
+ */
+export declare function hasArgFlag(flags: Map<string, string | true>, name: string): boolean;
+//# sourceMappingURL=cli.d.ts.map

package/dist/lib/skills/shared/utils/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../../../src/lib/skills/shared/utils/cli.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;CACnC;AAED;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;AAChF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;AASrF;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAK7D;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,CA6BrD;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;AACnG,wBAAgB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;AAYxG;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnF"}

package/dist/lib/skills/shared/utils/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../../../src/lib/skills/shared/utils/cli.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAyBH,0BAMC;AAUD,0BAKC;AASD,8BA6BC;AAWD,0BASC;AAQD,gCAEC;AAzFD,SAAgB,OAAO,CAAC,IAAc,EAAE,IAAY,EAAE,QAAuB;IAC3E,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,QAAQ,CAAC;IAChC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACpB,OAAO,GAAG,IAAI,QAAQ,CAAC;AACzB,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,OAAO,CAAC,IAAc,EAAE,IAAY;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACpB,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,SAAS,CAAC,IAAc;IACtC,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,0BAA0B;IAClD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE/C,0BAA0B;IAC1B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,GAAG,CAAC;YACrB,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAElB,kDAAkD;YAClD,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjD,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC7B,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;aAAM,CAAC;YACN,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;IAED,kDAAkD;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAEtC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AACrC,CAAC;AAWD,SAAgB,OAAO,CACrB,KAAiC,EACjC,IAAY,EACZ,QAAuB;IAEvB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACvC,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,QAAQ,CAAC,CAAC,yBAAyB;IAC5D,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,SAAgB,UAAU,CAAC,KAAiC,EAAE,IAAY;IACxE,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/dist/lib/skills/shared/utils/env.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Environment configuration for Lisa skills.
+ */
+export interface IEnvConfig {
+    STORAGE_MODE: 'local' | 'neo4j' | 'zep-cloud';
+    GRAPHITI_ENDPOINT: string;
+    GRAPHITI_GROUP_ID?: string;
+    NEO4J_URI: string;
+    NEO4J_USER: string;
+    NEO4J_PASSWORD: string;
+    NEO4J_DATABASE: string;
+    ZEP_API_KEY?: string;
+    ZEP_BASE_URL?: string;
+    LOG_LEVEL: 'debug' | 'info' | 'warn' | 'error' | 'silent';
+    LOG_DIR?: string;
+    LOG_CONSOLE: boolean;
+    raw: Record<string, string>;
+}
+/**
+ * Load environment configuration.
+ * Merges .lisa/.env with process.env (process.env takes precedence).
+ */
+export declare function loadEnv(): IEnvConfig;
+/**
+ * Check if Zep Cloud mode is configured and has required settings.
+ */
+export declare function isZepCloudConfigured(env: IEnvConfig): boolean;
+/**
+ * Check if Neo4j direct mode is configured.
+ */
+export declare function isNeo4jConfigured(env: IEnvConfig): boolean;
+/**
+ * Check if local MCP mode is configured (default).
+ */
+export declare function isLocalMcpConfigured(env: IEnvConfig): boolean;
+//# sourceMappingURL=env.d.ts.map

package/dist/lib/skills/shared/utils/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../../../src/lib/skills/shared/utils/env.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,WAAW,UAAU;IAEzB,YAAY,EAAE,OAAO,GAAG,OAAO,GAAG,WAAW,CAAC;IAG9C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAG3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IAGvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IAGrB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAgDD;;;GAGG;AACH,wBAAgB,OAAO,IAAI,UAAU,CA+BpC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAE7D"}

package/dist/lib/skills/shared/utils/env.js.map

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

package/dist/lib/skills/shared/utils/group-id.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Get the current folder's group ID (uses folder basename).
+ * E.g., "lisa" from "C:\dev\lisa" or "/home/user/projects/lisa"
+ *
+ * @param cwd - Current working directory (defaults to process.cwd())
+ * @returns Normalized group ID
+ */
+export declare function getCurrentGroupId(cwd?: string): string;
+/**
+ * Normalize a string to a valid Graphiti group ID.
+ * Graphiti requires alphanumeric characters, dashes, and underscores only.
+ *
+ * @param input - String to normalize
+ * @returns Normalized group ID
+ */
+export declare function normalizeGroupId(input: string): string;
+/**
+ * Get group IDs for querying.
+ * Returns array with current folder's group ID.
+ *
+ * @param cwd - Current working directory (defaults to process.cwd())
+ * @returns Array of group IDs to query
+ */
+export declare function getGroupIds(cwd?: string): string[];
+/**
+ * Generate a hierarchical list of group IDs from a path.
+ * E.g., "/home/user/projects/lisa/src" returns ["lisa", "projects", "user"]
+ *
+ * This allows querying memories from parent directories as well.
+ *
+ * @param cwd - Current working directory (defaults to process.cwd())
+ * @param maxDepth - Maximum number of parent levels to include
+ * @returns Array of group IDs from current to parents
+ */
+export declare function getHierarchicalGroupIds(cwd?: string, maxDepth?: number): string[];
+/**
+ * Create a Zep-compatible user ID from a group ID.
+ * E.g., "lisa" -> "lisa-user"
+ */
+export declare function createZepUserId(groupId: string): string;
+/**
+ * Create a Zep-compatible thread ID for a specific purpose.
+ * E.g., ("lisa", "memory") -> "lisa-memory-lisa"
+ */
+export declare function createZepThreadId(groupId: string, purpose: string): string;
+//# sourceMappingURL=group-id.d.ts.map

package/dist/lib/skills/shared/utils/group-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-id.d.ts","sourceRoot":"","sources":["../../../../../src/lib/skills/shared/utils/group-id.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAGrE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKtD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,EAAE,CAGjE;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,GAAE,MAAsB,EAC3B,QAAQ,GAAE,MAAU,GACnB,MAAM,EAAE,CAiBV;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1E"}

package/dist/lib/skills/shared/utils/group-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-id.js","sourceRoot":"","sources":["../../../../../src/lib/skills/shared/utils/group-id.ts"],"names":[],"mappings":";;;;;AAaA,8CAGC;AASD,4CAKC;AASD,kCAGC;AAYD,0DAoBC;AAMD,0CAEC;AAMD,8CAEC;AA1FD;;;GAGG;AACH,gDAAwB;AAExB;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAC3D,MAAM,QAAQ,GAAG,cAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACpC,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAC,KAAa;IAC5C,OAAO,KAAK;SACT,WAAW,EAAE;SACb,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAW,gCAAgC;SAC9D,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC,CAAC,0CAA0C;AAC7E,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,WAAW,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IACrD,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACvC,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAClC,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,uBAAuB,CACrC,MAAc,OAAO,CAAC,GAAG,EAAE,EAC3B,WAAmB,CAAC;IAEpB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,WAAW,GAAG,GAAG,CAAC;IAEtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,cAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,WAAW;YAAE,MAAM,CAAC,eAAe;QAEjE,MAAM,OAAO,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3C,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;QAED,WAAW,GAAG,cAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAAC,OAAe;IAC7C,OAAO,QAAQ,OAAO,EAAE,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,OAAe,EAAE,OAAe;IAChE,OAAO,QAAQ,OAAO,IAAI,OAAO,EAAE,CAAC;AACtC,CAAC"}

package/dist/lib/skills/shared/utils/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Shared utility implementations and interfaces.
+ */
+export * from './interfaces';
+export { createFileCache, createCacheConfigFromSkill } from './FileCache';
+export { createLogger, createConsoleLogger, logger } from './Logger';
+export { loadEnv, isZepCloudConfigured, isNeo4jConfigured, isLocalMcpConfigured, type IEnvConfig, } from './env';
+export { getCurrentGroupId, getGroupIds, getHierarchicalGroupIds, normalizeGroupId, createZepUserId, createZepThreadId, } from './group-id';
+export { popFlag, hasFlag, parseArgs, getFlag, hasArgFlag, type IParsedArgs, } from './cli';
+export { createCache, createCacheConfig, nullCache, type ICache, type ICacheConfig, } from './cache';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/skills/shared/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/skills/shared/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,cAAc,CAAC;AAG7B,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EACL,OAAO,EACP,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,UAAU,GAChB,MAAM,OAAO,CAAC;AACf,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,OAAO,EACP,OAAO,EACP,SAAS,EACT,OAAO,EACP,UAAU,EACV,KAAK,WAAW,GACjB,MAAM,OAAO,CAAC;AAGf,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,SAAS,EACT,KAAK,MAAM,EACX,KAAK,YAAY,GAClB,MAAM,SAAS,CAAC"}

package/dist/lib/skills/shared/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/lib/skills/shared/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;AAEH,uBAAuB;AACvB,+CAA6B;AAE7B,yCAAyC;AACzC,yCAA0E;AAAjE,4GAAA,eAAe,OAAA;AAAE,uHAAA,0BAA0B,OAAA;AACpD,mCAAqE;AAA5D,sGAAA,YAAY,OAAA;AAAE,6GAAA,mBAAmB,OAAA;AAAE,gGAAA,MAAM,OAAA;AAClD,6BAMe;AALb,8FAAA,OAAO,OAAA;AACP,2GAAA,oBAAoB,OAAA;AACpB,wGAAA,iBAAiB,OAAA;AACjB,2GAAA,oBAAoB,OAAA;AAGtB,uCAOoB;AANlB,6GAAA,iBAAiB,OAAA;AACjB,uGAAA,WAAW,OAAA;AACX,mHAAA,uBAAuB,OAAA;AACvB,4GAAA,gBAAgB,OAAA;AAChB,2GAAA,eAAe,OAAA;AACf,6GAAA,iBAAiB,OAAA;AAGnB,uBAAuB;AACvB,6BAOe;AANb,8FAAA,OAAO,OAAA;AACP,8FAAA,OAAO,OAAA;AACP,gGAAA,SAAS,OAAA;AACT,8FAAA,OAAO,OAAA;AACP,iGAAA,UAAU,OAAA;AAIZ,kBAAkB;AAClB,iCAMiB;AALf,oGAAA,WAAW,OAAA;AACX,0GAAA,iBAAiB,OAAA;AACjB,kGAAA,SAAS,OAAA"}

package/dist/lib/skills/shared/utils/interfaces/ICache.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Interface for cache operations.
+ * Used for storing and retrieving cached data (e.g., fallback for offline).
+ */
+export interface ICache {
+    /**
+     * Write data to cache.
+     * @param key - Cache key identifier
+     * @param data - Data to cache (will be JSON serialized)
+     */
+    write(key: string, data: unknown): void;
+    /**
+     * Read data from cache.
+     * @param key - Cache key identifier
+     * @returns Cached data or null if not found
+     */
+    read(key: string): unknown | null;
+    /**
+     * Read the most recent entry from a log-style cache.
+     * @param key - Cache key identifier
+     * @returns Most recent entry or null if not found
+     */
+    readLatest(key: string): unknown | null;
+    /**
+     * Get the file path for a cache key.
+     * @param key - Cache key identifier
+     * @returns Absolute file path
+     */
+    getFilePath(key: string): string;
+    /**
+     * Clear all entries for a cache key.
+     * @param key - Cache key identifier
+     */
+    clear(key: string): void;
+}
+/**
+ * Configuration options for creating a cache.
+ */
+export interface ICacheConfig {
+    /** Directory to store cache files */
+    cacheDir: string;
+    /** Maximum cache file size in bytes before rotation */
+    maxSizeBytes?: number;
+    /** Whether to append (log style) or overwrite */
+    appendMode?: boolean;
+}
+//# sourceMappingURL=ICache.d.ts.map

package/dist/lib/skills/shared/utils/interfaces/ICache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICache.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/skills/shared/utils/interfaces/ICache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAExC;;;;OAIG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAElC;;;;OAIG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAExC;;;;OAIG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAEjC;;;OAGG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}

package/dist/lib/skills/shared/utils/interfaces/ICache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICache.js","sourceRoot":"","sources":["../../../../../../src/lib/skills/shared/utils/interfaces/ICache.ts"],"names":[],"mappings":""}

package/dist/lib/skills/shared/utils/interfaces/ILogger.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Interface for logging operations.
+ * Provides structured logging with context support.
+ */
+export interface ILogger {
+    /**
+     * Log a debug message.
+     * @param message - Log message
+     * @param context - Optional structured context
+     */
+    debug(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log an info message.
+     * @param message - Log message
+     * @param context - Optional structured context
+     */
+    info(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log a warning message.
+     * @param message - Log message
+     * @param context - Optional structured context
+     */
+    warn(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log an error message.
+     * @param message - Log message
+     * @param context - Optional structured context
+     */
+    error(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Create a child logger with additional bindings.
+     * @param bindings - Context bindings to include in all messages
+     * @returns A new logger instance with the bindings
+     */
+    child(bindings: Record<string, unknown>): ILogger;
+}
+/**
+ * Log levels in order of severity.
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+/**
+ * Configuration options for creating a logger.
+ */
+export interface ILoggerConfig {
+    /** Logger name/component identifier */
+    name: string;
+    /** Minimum log level to output */
+    level?: LogLevel;
+    /** Output destination ('stdout', 'stderr', or file path) */
+    destination?: string;
+    /** Pretty print for development */
+    prettyPrint?: boolean;
+}
+//# sourceMappingURL=ILogger.d.ts.map

package/dist/lib/skills/shared/utils/interfaces/ILogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILogger.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/skills/shared/utils/interfaces/ILogger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAEhE;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE/D;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE/D;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAEhE;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}

package/dist/lib/skills/shared/utils/interfaces/ILogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILogger.js","sourceRoot":"","sources":["../../../../../../src/lib/skills/shared/utils/interfaces/ILogger.ts"],"names":[],"mappings":""}

package/dist/lib/skills/shared/utils/interfaces/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Utility interfaces for shared functionality.
+ */
+export * from './ICache';
+export * from './ILogger';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/skills/shared/utils/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/skills/shared/utils/interfaces/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC"}