@agentxjs/common 1.8.0 → 1.9.0

package/README.md

@@ -6,16 +6,17 @@
 
 `@agentxjs/common` provides shared utilities used by AgentX internal packages (`@agentxjs/agent`, `@agentxjs/runtime`, etc.). This is an internal package - application code should not depend on it directly.
 
-**Key Features:**
+**Modules:**
 
-- **Logger Facade** - Lazy-initialized logging with pluggable backends
-- **Zero Runtime Overhead** - Safe to use at module level
-- **Pluggable Architecture** - Custom loggers via Runtime injection
+| Module | Import                    | Description                                      |
+| ------ | ------------------------- | ------------------------------------------------ |
+| Logger | `@agentxjs/common`        | Lazy-initialized logging with pluggable backends |
+| SQLite | `@agentxjs/common/sqlite` | Unified SQLite abstraction for Bun/Node.js       |
 
 ## Installation
 
 ```bash
-pnpm add @agentxjs/common
+bun add @agentxjs/common
 ```
 
 > **Note**: This package is typically installed transitively as a dependency of other AgentX packages.
@@ -94,12 +95,6 @@ Creates a new logger instance.
 const logger = createLogger("agent/MyAgent");
 ```
 
-**Parameters:**
-
-- `category` - Logger category (e.g., `"engine/AgentEngine"`, `"runtime/Container"`)
-
-**Returns:** `Logger` instance
-
 #### `setLoggerFactory(factory: LoggerFactory): void`
 
 Sets the global logger factory (called by Runtime).
@@ -115,154 +110,266 @@ setLoggerFactory(
 );
 ```
 
-### Logger Interface
+---
+
+## SQLite
+
+Unified SQLite abstraction that auto-detects runtime:
+
+- **Bun** → uses `bun:sqlite` (built-in)
+- **Node.js 22+** → uses `node:sqlite` (built-in)
+
+### Quick Start
 
 ```typescript
-interface Logger {
-  debug(message: string, context?: LogContext): void;
-  info(message: string, context?: LogContext): void;
-  warn(message: string, context?: LogContext): void;
-  error(message: string, context?: LogContext): void;
-}
+import { openDatabase } from "@agentxjs/common/sqlite";
+
+const db = openDatabase("./data/app.db");
+
+// Create tables
+db.exec(`
+  CREATE TABLE IF NOT EXISTS users (
+    id INTEGER PRIMARY KEY,
+    name TEXT NOT NULL
+  )
+`);
 
-type LogContext = Record<string, unknown>;
+// Insert data
+db.prepare("INSERT INTO users (name) VALUES (?)").run("Alice");
+
+// Query data
+const users = db.prepare("SELECT * FROM users").all();
+console.log(users); // [{ id: 1, name: "Alice" }]
+
+// Close when done
+db.close();
 ```
 
----
+### API
 
-## Built-in Implementations
+#### `openDatabase(path: string): Database`
 
-### ConsoleLogger
+Opens a SQLite database.
 
-Default console-based logger with formatting.
+```typescript
+import { openDatabase } from "@agentxjs/common/sqlite";
+
+// File-based database
+const db = openDatabase("./data/app.db");
+
+// In-memory database (for testing)
+const memDb = openDatabase(":memory:");
+```
+
+### Database Interface
 
 ```typescript
-import { ConsoleLogger } from "@agentxjs/common";
+interface Database {
+  /** Execute raw SQL (no return value) */
+  exec(sql: string): void;
 
-const logger = new ConsoleLogger("my-category", {
-  level: "debug",
-  enableTimestamp: true,
-  enableColor: true,
-});
+  /** Prepare a statement */
+  prepare(sql: string): Statement;
 
-logger.info("Hello", { foo: "bar" });
-// Output: [INFO] my-category: Hello {"foo":"bar"}
+  /** Close the database */
+  close(): void;
+}
+
+interface Statement {
+  /** Execute with params, return changes */
+  run(...params: unknown[]): RunResult;
+
+  /** Get single row */
+  get(...params: unknown[]): unknown;
+
+  /** Get all rows */
+  all(...params: unknown[]): unknown[];
+}
+
+interface RunResult {
+  changes: number;
+  lastInsertRowid: number | bigint;
+}
 ```
 
-**Options:**
+### Example: Key-Value Store
 
 ```typescript
-interface ConsoleLoggerOptions {
-  level?: LogLevel; // Minimum log level (default: "info")
-  enableTimestamp?: boolean; // Show timestamps (default: false)
-  enableColor?: boolean; // Colorize output (default: true in TTY)
+import { openDatabase } from "@agentxjs/common/sqlite";
+
+const db = openDatabase("./kv.db");
+
+db.exec(`
+  CREATE TABLE IF NOT EXISTS kv (
+    key TEXT PRIMARY KEY,
+    value TEXT
+  )
+`);
+
+function set(key: string, value: unknown) {
+  const json = JSON.stringify(value);
+  db.prepare("INSERT OR REPLACE INTO kv (key, value) VALUES (?, ?)").run(key, json);
 }
+
+function get<T>(key: string): T | null {
+  const row = db.prepare("SELECT value FROM kv WHERE key = ?").get(key) as
+    | { value: string }
+    | undefined;
+  return row ? JSON.parse(row.value) : null;
+}
+
+set("user:1", { name: "Alice", age: 30 });
+console.log(get("user:1")); // { name: "Alice", age: 30 }
 ```
 
-### LoggerFactoryImpl
+---
 
-Default factory that creates `ConsoleLogger` instances.
+## Path Utilities
+
+Cross-runtime path helpers that work in both Bun and Node.js.
+
+### Quick Start
 
 ```typescript
-import { LoggerFactoryImpl } from "@agentxjs/common";
+import {
+  getModuleDir,
+  getPackageRoot,
+  getMonorepoRoot,
+  resolveFromRoot,
+  resolveFromPackage,
+} from "@agentxjs/common/path";
+
+// Current module directory
+const __dirname = getModuleDir(import.meta);
+// e.g., /Users/sean/AgentX/packages/queue/src
+
+// Package root (where package.json is)
+const pkgRoot = getPackageRoot(import.meta);
+// e.g., /Users/sean/AgentX/packages/queue
+
+// Monorepo root
+const root = getMonorepoRoot(import.meta);
+// e.g., /Users/sean/AgentX
+
+// Resolve from monorepo root
+const dataDir = resolveFromRoot(import.meta, "data", "logs");
+// e.g., /Users/sean/AgentX/data/logs
+
+// Resolve from package root
+const testsDir = resolveFromPackage(import.meta, "tests", "fixtures");
+// e.g., /Users/sean/AgentX/packages/queue/tests/fixtures
+```
 
-const factory = new LoggerFactoryImpl({
-  level: "info",
-  enableTimestamp: false,
-});
+### API
 
-const logger = factory.createLogger("test");
+#### `getModuleDir(meta: ImportMeta): string`
+
+Get the directory of the current module.
+
+```typescript
+const __dirname = getModuleDir(import.meta);
 ```
 
----
+**Compatibility:**
 
-## Custom Logger Implementation
+- Bun: uses `import.meta.dir`
+- Node.js: converts `import.meta.url` to path
 
-You can provide custom loggers for advanced use cases:
+#### `getPackageRoot(meta: ImportMeta): string`
+
+Get the package root directory (walks up to find `package.json`).
 
 ```typescript
-import { Logger, LoggerFactory, setLoggerFactory } from "@agentxjs/common";
-
-// Custom logger (e.g., sends logs to external service)
-class RemoteLogger implements Logger {
-  constructor(private category: string) {}
-
-  debug(message: string, context?: LogContext) {
-    this.send("debug", message, context);
-  }
-
-  info(message: string, context?: LogContext) {
-    this.send("info", message, context);
-  }
-
-  warn(message: string, context?: LogContext) {
-    this.send("warn", message, context);
-  }
-
-  error(message: string, context?: LogContext) {
-    this.send("error", message, context);
-  }
-
-  private send(level: string, message: string, context?: LogContext) {
-    fetch("/api/logs", {
-      method: "POST",
-      body: JSON.stringify({ level, category: this.category, message, context }),
-    });
-  }
-}
+const pkgRoot = getPackageRoot(import.meta);
+```
 
-// Custom factory
-class RemoteLoggerFactory implements LoggerFactory {
-  createLogger(category: string): Logger {
-    return new RemoteLogger(category);
-  }
-}
+#### `getMonorepoRoot(meta: ImportMeta): string`
 
-// Use custom factory
-setLoggerFactory(new RemoteLoggerFactory());
+Get the monorepo root directory (walks up to find lock files).
+
+```typescript
+const root = getMonorepoRoot(import.meta);
 ```
 
----
+**Detects:**
 
-## Design Decisions
+- `pnpm-workspace.yaml` (pnpm monorepo)
+- `bun.lock` (bun workspace)
+- `package-lock.json` (npm workspace)
+- `yarn.lock` (yarn workspace)
 
-### Why Lazy Initialization?
+#### `resolveFromRoot(meta: ImportMeta, ...paths: string[]): string`
 
-AgentX packages create loggers at module level:
+Resolve a path relative to the monorepo root.
 
 ```typescript
-// engine/AgentEngine.ts
-import { createLogger } from "@agentxjs/common";
+const configPath = resolveFromRoot(import.meta, "config", "settings.json");
+```
 
-const logger = createLogger("engine/AgentEngine");
+#### `resolveFromPackage(meta: ImportMeta, ...paths: string[]): string`
 
-export class AgentEngine {
-  // ...
-}
+Resolve a path relative to the package root.
+
+```typescript
+const testData = resolveFromPackage(import.meta, "tests", "fixtures", "data.json");
 ```
 
-If loggers required immediate factory, this would fail before Runtime initializes. Lazy initialization solves this.
+### Example: Test Fixtures
 
-### Why Pluggable?
+```typescript
+import { resolveFromPackage } from "@agentxjs/common/path";
+import { readFileSync } from "node:fs";
 
-Different environments need different logging:
+// Load test fixture from current package
+const fixturePath = resolveFromPackage(import.meta, "tests", "fixtures", "sample.json");
+const data = JSON.parse(readFileSync(fixturePath, "utf-8"));
+```
 
-- **Development** - Console with colors
-- **Production** - Structured JSON logs
-- **Browser** - Send to analytics service
-- **Testing** - Silent or mock
+---
 
-Runtime provides the logger factory appropriate for the environment.
+## Built-in Implementations
 
-### Why Not Use console.log Directly?
+### ConsoleLogger
 
-Direct `console.log` usage causes:
+Default console-based logger with formatting.
 
-1. **No control** - Can't disable/filter logs
-2. **No structure** - Context is hard to parse
-3. **No routing** - Can't send logs to services
+```typescript
+import { ConsoleLogger } from "@agentxjs/common";
 
-The logger facade solves all these issues.
+const logger = new ConsoleLogger("my-category", {
+  level: "debug",
+  enableTimestamp: true,
+  enableColor: true,
+});
+
+logger.info("Hello", { foo: "bar" });
+// Output: [INFO] my-category: Hello {"foo":"bar"}
+```
+
+**Options:**
+
+```typescript
+interface ConsoleLoggerOptions {
+  level?: LogLevel; // Minimum log level (default: "info")
+  enableTimestamp?: boolean; // Show timestamps (default: false)
+  enableColor?: boolean; // Colorize output (default: true in TTY)
+}
+```
+
+### LoggerFactoryImpl
+
+Default factory that creates `ConsoleLogger` instances.
+
+```typescript
+import { LoggerFactoryImpl } from "@agentxjs/common";
+
+const factory = new LoggerFactoryImpl({
+  level: "info",
+  enableTimestamp: false,
+});
+
+const logger = factory.createLogger("test");
+```
 
 ---
 
@@ -271,9 +378,11 @@ The logger facade solves all these issues.
 ```text
 @agentxjs/types     Type definitions
        ↑
-@agentxjs/common    This package (logger facade)
+@agentxjs/common    This package (logger + sqlite)
+       ↑
+@agentxjs/queue     Uses sqlite
        ↑
-@agentxjs/agent     Uses logger
+@agentxjs/persistence  Uses sqlite
        ↑
 @agentxjs/runtime   Uses logger + provides factory
 ```
@@ -283,8 +392,9 @@ The logger facade solves all these issues.
 ## Related Packages
 
 - **[@agentxjs/types](../types)** - Type definitions
-- **[@agentxjs/agent](../agent)** - Agent runtime (uses logger)
-- **[@agentxjs/runtime](../runtime)** - Runtime implementation (provides factory)
+- **[@agentxjs/queue](../queue)** - Event queue (uses SQLite)
+- **[@agentxjs/persistence](../persistence)** - Storage layer (uses SQLite)
+- **[@agentxjs/runtime](../runtime)** - Runtime implementation
 
 ---
 

package/dist/index.d.ts

@@ -59,4 +59,40 @@ declare function setLoggerFactory(factory: LoggerFactory): void;
 * @returns Logger instance (lazy proxy)
 */
 declare function createLogger(name: string): Logger2;
-export { setLoggerFactory, createLogger, LoggerFactoryImpl, LoggerFactoryConfig, LoggerFactory2 as LoggerFactory, Logger3 as Logger, LogLevel3 as LogLevel, LogContext2 as LogContext, ConsoleLoggerOptions, ConsoleLogger };
+/**
+* ID Generation Utilities
+*
+* Provides consistent ID generation patterns across the AgentX platform.
+*
+* @packageDocumentation
+*/
+/**
+* Generate a unique request ID for command request/response correlation.
+*
+* Format: `req_{timestamp}_{random}`
+*
+* @example
+* ```typescript
+* const requestId = generateRequestId();
+* // => "req_1704067200000_a1b2c3"
+* ```
+*/
+declare function generateRequestId(): string;
+/**
+* Generate a unique ID with a custom prefix.
+*
+* Format: `{prefix}_{timestamp}_{random}`
+*
+* @param prefix - The prefix for the ID (e.g., "msg", "agent", "session")
+*
+* @example
+* ```typescript
+* const msgId = generateId("msg");
+* // => "msg_1704067200000_a1b2c3"
+*
+* const agentId = generateId("agent");
+* // => "agent_1704067200000_x7y8z9"
+* ```
+*/
+declare function generateId(prefix: string): string;
+export { setLoggerFactory, generateRequestId, generateId, createLogger, LoggerFactoryImpl, LoggerFactoryConfig, LoggerFactory2 as LoggerFactory, Logger3 as Logger, LogLevel3 as LogLevel, LogContext2 as LogContext, ConsoleLoggerOptions, ConsoleLogger };

package/dist/index.js

@@ -173,11 +173,20 @@ function setLoggerFactory(factory) {
 function createLogger(name) {
   return LoggerFactoryImpl.getLogger(name);
 }
+// src/id/index.ts
+function generateRequestId() {
+  return `req_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;
+}
+function generateId(prefix) {
+  return `${prefix}_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+}
 export {
   setLoggerFactory,
+  generateRequestId,
+  generateId,
   createLogger,
   LoggerFactoryImpl,
   ConsoleLogger
 };
 
-//# debugId=4E9DCBA7473CCEA164756E2164756E21
+//# debugId=1EB63110DA82C92A64756E2164756E21

package/dist/index.js.map

@@ -1,11 +1,12 @@
 {
   "version": 3,
-  "sources": ["../src/logger/ConsoleLogger.ts", "../src/logger/LoggerFactoryImpl.ts"],
+  "sources": ["../src/logger/ConsoleLogger.ts", "../src/logger/LoggerFactoryImpl.ts", "../src/id/index.ts"],
   "sourcesContent": [
     "/**\n * ConsoleLogger - Default logger implementation\n *\n * Simple console-based logger with color support.\n * Used as fallback when no custom LoggerFactory is provided.\n */\n\nimport type { Logger, LogContext, LogLevel } from \"@agentxjs/types\";\n\nexport interface ConsoleLoggerOptions {\n  level?: LogLevel;\n  colors?: boolean;\n  timestamps?: boolean;\n}\n\nexport class ConsoleLogger implements Logger {\n  readonly name: string;\n  readonly level: LogLevel;\n  private readonly colors: boolean;\n  private readonly timestamps: boolean;\n\n  private static readonly COLORS = {\n    DEBUG: \"\\x1b[36m\",\n    INFO: \"\\x1b[32m\",\n    WARN: \"\\x1b[33m\",\n    ERROR: \"\\x1b[31m\",\n    RESET: \"\\x1b[0m\",\n  };\n\n  constructor(name: string, options: ConsoleLoggerOptions = {}) {\n    this.name = name;\n    this.level = options.level ?? \"info\";\n    this.colors = options.colors ?? this.isNodeEnvironment();\n    this.timestamps = options.timestamps ?? true;\n  }\n\n  debug(message: string, context?: LogContext): void {\n    if (this.isDebugEnabled()) {\n      this.log(\"DEBUG\", message, context);\n    }\n  }\n\n  info(message: string, context?: LogContext): void {\n    if (this.isInfoEnabled()) {\n      this.log(\"INFO\", message, context);\n    }\n  }\n\n  warn(message: string, context?: LogContext): void {\n    if (this.isWarnEnabled()) {\n      this.log(\"WARN\", message, context);\n    }\n  }\n\n  error(message: string | Error, context?: LogContext): void {\n    if (this.isErrorEnabled()) {\n      if (message instanceof Error) {\n        this.log(\"ERROR\", message.message, { ...context, stack: message.stack });\n      } else {\n        this.log(\"ERROR\", message, context);\n      }\n    }\n  }\n\n  isDebugEnabled(): boolean {\n    return this.getLevelValue(this.level) <= this.getLevelValue(\"debug\");\n  }\n\n  isInfoEnabled(): boolean {\n    return this.getLevelValue(this.level) <= this.getLevelValue(\"info\");\n  }\n\n  isWarnEnabled(): boolean {\n    return this.getLevelValue(this.level) <= this.getLevelValue(\"warn\");\n  }\n\n  isErrorEnabled(): boolean {\n    return this.getLevelValue(this.level) <= this.getLevelValue(\"error\");\n  }\n\n  private getLevelValue(level: LogLevel): number {\n    const levels: Record<LogLevel, number> = {\n      debug: 0,\n      info: 1,\n      warn: 2,\n      error: 3,\n      silent: 4,\n    };\n    return levels[level];\n  }\n\n  private log(level: string, message: string, context?: LogContext): void {\n    const parts: string[] = [];\n\n    if (this.timestamps) {\n      parts.push(new Date().toISOString());\n    }\n\n    if (this.colors) {\n      const color = ConsoleLogger.COLORS[level as keyof typeof ConsoleLogger.COLORS];\n      parts.push(`${color}${level.padEnd(5)}${ConsoleLogger.COLORS.RESET}`);\n    } else {\n      parts.push(level.padEnd(5));\n    }\n\n    parts.push(`[${this.name}]`);\n    parts.push(message);\n\n    const logLine = parts.join(\" \");\n    const consoleMethod = this.getConsoleMethod(level);\n\n    if (context && Object.keys(context).length > 0) {\n      consoleMethod(logLine, context);\n    } else {\n      consoleMethod(logLine);\n    }\n  }\n\n  private getConsoleMethod(level: string): (...args: unknown[]) => void {\n    switch (level) {\n      case \"DEBUG\":\n        return console.debug.bind(console);\n      case \"INFO\":\n        return console.info.bind(console);\n      case \"WARN\":\n        return console.warn.bind(console);\n      case \"ERROR\":\n        return console.error.bind(console);\n      default:\n        return console.log.bind(console);\n    }\n  }\n\n  private isNodeEnvironment(): boolean {\n    return typeof process !== \"undefined\" && process.versions?.node !== undefined;\n  }\n}\n",
-    "/**\n * LoggerFactoryImpl - Central factory for creating logger instances\n *\n * Implements lazy initialization pattern:\n * - createLogger() can be called at module level (before config)\n * - Real logger is created on first use\n * - External LoggerFactory can be injected via Runtime\n */\n\nimport type { Logger, LoggerFactory, LogContext, LogLevel } from \"@agentxjs/types\";\nimport { ConsoleLogger, type ConsoleLoggerOptions } from \"./ConsoleLogger\";\n\n// External factory injected via Runtime\nlet externalFactory: LoggerFactory | null = null;\n\n// Version counter to invalidate cached real loggers\nlet factoryVersion = 0;\n\nexport interface LoggerFactoryConfig {\n  defaultImplementation?: (name: string) => Logger;\n  defaultLevel?: LogLevel;\n  consoleOptions?: Omit<ConsoleLoggerOptions, \"level\">;\n}\n\n/**\n * Internal LoggerFactory implementation\n *\n * Uses lazy proxy pattern to allow module-level createLogger() calls.\n */\nexport class LoggerFactoryImpl {\n  private static loggers: Map<string, Logger> = new Map();\n  private static config: LoggerFactoryConfig = {\n    defaultLevel: \"info\",\n  };\n\n  static getLogger(nameOrClass: string | (new (...args: unknown[]) => unknown)): Logger {\n    const name = typeof nameOrClass === \"string\" ? nameOrClass : nameOrClass.name;\n\n    if (this.loggers.has(name)) {\n      return this.loggers.get(name)!;\n    }\n\n    const lazyLogger = this.createLazyLogger(name);\n    this.loggers.set(name, lazyLogger);\n    return lazyLogger;\n  }\n\n  static configure(config: LoggerFactoryConfig): void {\n    this.config = { ...this.config, ...config };\n  }\n\n  static reset(): void {\n    this.loggers.clear();\n    this.config = { defaultLevel: \"info\" };\n    externalFactory = null;\n    factoryVersion++; // Invalidate all cached real loggers\n  }\n\n  private static createLazyLogger(name: string): Logger {\n    let realLogger: Logger | null = null;\n    let loggerVersion = -1; // Track which factory version created this logger\n\n    const getRealLogger = (): Logger => {\n      // Recreate logger if factory version changed (setLoggerFactory was called)\n      if (!realLogger || loggerVersion !== factoryVersion) {\n        realLogger = this.createLogger(name);\n        loggerVersion = factoryVersion;\n      }\n      return realLogger;\n    };\n\n    return {\n      name,\n      level: this.config.defaultLevel || \"info\",\n      debug: (message: string, context?: LogContext) => getRealLogger().debug(message, context),\n      info: (message: string, context?: LogContext) => getRealLogger().info(message, context),\n      warn: (message: string, context?: LogContext) => getRealLogger().warn(message, context),\n      error: (message: string | Error, context?: LogContext) =>\n        getRealLogger().error(message, context),\n      isDebugEnabled: () => getRealLogger().isDebugEnabled(),\n      isInfoEnabled: () => getRealLogger().isInfoEnabled(),\n      isWarnEnabled: () => getRealLogger().isWarnEnabled(),\n      isErrorEnabled: () => getRealLogger().isErrorEnabled(),\n    };\n  }\n\n  private static createLogger(name: string): Logger {\n    if (externalFactory) {\n      return externalFactory.getLogger(name);\n    }\n\n    if (this.config.defaultImplementation) {\n      return this.config.defaultImplementation(name);\n    }\n\n    return new ConsoleLogger(name, {\n      level: this.config.defaultLevel,\n      ...this.config.consoleOptions,\n    });\n  }\n}\n\n/**\n * Set external LoggerFactory (called by Runtime initialization)\n */\nexport function setLoggerFactory(factory: LoggerFactory): void {\n  externalFactory = factory;\n  LoggerFactoryImpl.reset();\n  externalFactory = factory;\n}\n\n/**\n * Create a logger instance\n *\n * Safe to call at module level before Runtime is configured.\n * Uses lazy initialization - actual logger is created on first use.\n *\n * @param name - Logger name (hierarchical, e.g., \"engine/AgentEngine\")\n * @returns Logger instance (lazy proxy)\n */\nexport function createLogger(name: string): Logger {\n  return LoggerFactoryImpl.getLogger(name);\n}\n"
+    "/**\n * LoggerFactoryImpl - Central factory for creating logger instances\n *\n * Implements lazy initialization pattern:\n * - createLogger() can be called at module level (before config)\n * - Real logger is created on first use\n * - External LoggerFactory can be injected via Runtime\n */\n\nimport type { Logger, LoggerFactory, LogContext, LogLevel } from \"@agentxjs/types\";\nimport { ConsoleLogger, type ConsoleLoggerOptions } from \"./ConsoleLogger\";\n\n// External factory injected via Runtime\nlet externalFactory: LoggerFactory | null = null;\n\n// Version counter to invalidate cached real loggers\nlet factoryVersion = 0;\n\nexport interface LoggerFactoryConfig {\n  defaultImplementation?: (name: string) => Logger;\n  defaultLevel?: LogLevel;\n  consoleOptions?: Omit<ConsoleLoggerOptions, \"level\">;\n}\n\n/**\n * Internal LoggerFactory implementation\n *\n * Uses lazy proxy pattern to allow module-level createLogger() calls.\n */\nexport class LoggerFactoryImpl {\n  private static loggers: Map<string, Logger> = new Map();\n  private static config: LoggerFactoryConfig = {\n    defaultLevel: \"info\",\n  };\n\n  static getLogger(nameOrClass: string | (new (...args: unknown[]) => unknown)): Logger {\n    const name = typeof nameOrClass === \"string\" ? nameOrClass : nameOrClass.name;\n\n    if (this.loggers.has(name)) {\n      return this.loggers.get(name)!;\n    }\n\n    const lazyLogger = this.createLazyLogger(name);\n    this.loggers.set(name, lazyLogger);\n    return lazyLogger;\n  }\n\n  static configure(config: LoggerFactoryConfig): void {\n    this.config = { ...this.config, ...config };\n  }\n\n  static reset(): void {\n    this.loggers.clear();\n    this.config = { defaultLevel: \"info\" };\n    externalFactory = null;\n    factoryVersion++; // Invalidate all cached real loggers\n  }\n\n  private static createLazyLogger(name: string): Logger {\n    let realLogger: Logger | null = null;\n    let loggerVersion = -1; // Track which factory version created this logger\n\n    const getRealLogger = (): Logger => {\n      // Recreate logger if factory version changed (setLoggerFactory was called)\n      if (!realLogger || loggerVersion !== factoryVersion) {\n        realLogger = this.createLogger(name);\n        loggerVersion = factoryVersion;\n      }\n      return realLogger;\n    };\n\n    return {\n      name,\n      level: this.config.defaultLevel || \"info\",\n      debug: (message: string, context?: LogContext) => getRealLogger().debug(message, context),\n      info: (message: string, context?: LogContext) => getRealLogger().info(message, context),\n      warn: (message: string, context?: LogContext) => getRealLogger().warn(message, context),\n      error: (message: string | Error, context?: LogContext) =>\n        getRealLogger().error(message, context),\n      isDebugEnabled: () => getRealLogger().isDebugEnabled(),\n      isInfoEnabled: () => getRealLogger().isInfoEnabled(),\n      isWarnEnabled: () => getRealLogger().isWarnEnabled(),\n      isErrorEnabled: () => getRealLogger().isErrorEnabled(),\n    };\n  }\n\n  private static createLogger(name: string): Logger {\n    if (externalFactory) {\n      return externalFactory.getLogger(name);\n    }\n\n    if (this.config.defaultImplementation) {\n      return this.config.defaultImplementation(name);\n    }\n\n    return new ConsoleLogger(name, {\n      level: this.config.defaultLevel,\n      ...this.config.consoleOptions,\n    });\n  }\n}\n\n/**\n * Set external LoggerFactory (called by Runtime initialization)\n */\nexport function setLoggerFactory(factory: LoggerFactory): void {\n  externalFactory = factory;\n  LoggerFactoryImpl.reset();\n  externalFactory = factory;\n}\n\n/**\n * Create a logger instance\n *\n * Safe to call at module level before Runtime is configured.\n * Uses lazy initialization - actual logger is created on first use.\n *\n * @param name - Logger name (hierarchical, e.g., \"engine/AgentEngine\")\n * @returns Logger instance (lazy proxy)\n */\nexport function createLogger(name: string): Logger {\n  return LoggerFactoryImpl.getLogger(name);\n}\n",
+    "/**\n * ID Generation Utilities\n *\n * Provides consistent ID generation patterns across the AgentX platform.\n *\n * @packageDocumentation\n */\n\n/**\n * Generate a unique request ID for command request/response correlation.\n *\n * Format: `req_{timestamp}_{random}`\n *\n * @example\n * ```typescript\n * const requestId = generateRequestId();\n * // => \"req_1704067200000_a1b2c3\"\n * ```\n */\nexport function generateRequestId(): string {\n  return `req_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;\n}\n\n/**\n * Generate a unique ID with a custom prefix.\n *\n * Format: `{prefix}_{timestamp}_{random}`\n *\n * @param prefix - The prefix for the ID (e.g., \"msg\", \"agent\", \"session\")\n *\n * @example\n * ```typescript\n * const msgId = generateId(\"msg\");\n * // => \"msg_1704067200000_a1b2c3\"\n *\n * const agentId = generateId(\"agent\");\n * // => \"agent_1704067200000_x7y8z9\"\n * ```\n */\nexport function generateId(prefix: string): string {\n  return `${prefix}_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "4E9DCBA7473CCEA164756E2164756E21",
+  "mappings": "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",
+  "debugId": "1EB63110DA82C92A64756E2164756E21",
   "names": []
 }

package/dist/path/index.d.ts

@@ -0,0 +1,83 @@
+/**
+* Get the directory of the current module
+*
+* @param meta - Pass `import.meta` from your module
+* @returns Absolute path to the directory containing the module
+*
+* @example
+* ```typescript
+* import { getModuleDir } from "@agentxjs/common/path";
+*
+* const __dirname = getModuleDir(import.meta);
+* ```
+*/
+declare function getModuleDir(meta: ImportMeta): string;
+/**
+* Get the root directory of the current package (where package.json is)
+*
+* @param meta - Pass `import.meta` from your module
+* @returns Absolute path to the package root
+*
+* @example
+* ```typescript
+* import { getPackageRoot } from "@agentxjs/common/path";
+*
+* const pkgRoot = getPackageRoot(import.meta);
+* // e.g., /Users/sean/AgentX/packages/queue
+* ```
+*/
+declare function getPackageRoot(meta: ImportMeta): string;
+/**
+* Get the monorepo root directory (where pnpm-workspace.yaml or root package.json is)
+*
+* @param meta - Pass `import.meta` from your module
+* @returns Absolute path to the monorepo root
+*
+* @example
+* ```typescript
+* import { getMonorepoRoot } from "@agentxjs/common/path";
+*
+* const root = getMonorepoRoot(import.meta);
+* // e.g., /Users/sean/AgentX
+* ```
+*/
+declare function getMonorepoRoot(meta: ImportMeta): string;
+/**
+* Resolve a path relative to the monorepo root
+*
+* @param meta - Pass `import.meta` from your module
+* @param paths - Path segments to resolve
+* @returns Absolute resolved path
+*
+* @example
+* ```typescript
+* import { resolveFromRoot } from "@agentxjs/common/path";
+*
+* const dataDir = resolveFromRoot(import.meta, "data");
+* // e.g., /Users/sean/AgentX/data
+*
+* const config = resolveFromRoot(import.meta, "packages", "config", "settings.json");
+* // e.g., /Users/sean/AgentX/packages/config/settings.json
+* ```
+*/
+declare function resolveFromRoot(meta: ImportMeta, ...paths: string[]): string;
+/**
+* Resolve a path relative to the current package root
+*
+* @param meta - Pass `import.meta` from your module
+* @param paths - Path segments to resolve
+* @returns Absolute resolved path
+*
+* @example
+* ```typescript
+* import { resolveFromPackage } from "@agentxjs/common/path";
+*
+* const testsDir = resolveFromPackage(import.meta, "tests");
+* // e.g., /Users/sean/AgentX/packages/queue/tests
+*
+* const fixtures = resolveFromPackage(import.meta, "tests", "fixtures", "data.json");
+* // e.g., /Users/sean/AgentX/packages/queue/tests/fixtures/data.json
+* ```
+*/
+declare function resolveFromPackage(meta: ImportMeta, ...paths: string[]): string;
+export { resolveFromRoot, resolveFromPackage, getPackageRoot, getMonorepoRoot, getModuleDir };

package/dist/path/index.js

@@ -0,0 +1,63 @@
+// src/path/path.ts
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { existsSync } from "node:fs";
+function getModuleDir(meta) {
+  if (meta.dir) {
+    return meta.dir;
+  }
+  return dirname(fileURLToPath(meta.url));
+}
+function getPackageRoot(meta) {
+  const startDir = getModuleDir(meta);
+  return findUp(startDir, "package.json");
+}
+function getMonorepoRoot(meta) {
+  const startDir = getModuleDir(meta);
+  const markers = [
+    "pnpm-workspace.yaml",
+    "pnpm-lock.yaml",
+    "bun.lock",
+    "bun.lockb",
+    "package-lock.json",
+    "yarn.lock"
+  ];
+  for (const marker of markers) {
+    try {
+      return findUp(startDir, marker);
+    } catch {}
+  }
+  return findUp(startDir, "package.json");
+}
+function resolveFromRoot(meta, ...paths) {
+  const root = getMonorepoRoot(meta);
+  return resolve(root, ...paths);
+}
+function resolveFromPackage(meta, ...paths) {
+  const pkgRoot = getPackageRoot(meta);
+  return resolve(pkgRoot, ...paths);
+}
+function findUp(startDir, filename) {
+  let current = startDir;
+  const root = resolve("/");
+  while (current !== root) {
+    const candidate = resolve(current, filename);
+    if (existsSync(candidate)) {
+      return current;
+    }
+    const parent = dirname(current);
+    if (parent === current)
+      break;
+    current = parent;
+  }
+  throw new Error(`Could not find ${filename} starting from ${startDir}`);
+}
+export {
+  resolveFromRoot,
+  resolveFromPackage,
+  getPackageRoot,
+  getMonorepoRoot,
+  getModuleDir
+};
+
+//# debugId=6C5E3AD0868C9DBF64756E2164756E21

package/dist/path/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../src/path/path.ts"],
+  "sourcesContent": [
+    "/**\n * Path Utilities - Cross-runtime path helpers\n *\n * Works in both Bun and Node.js environments.\n */\n\nimport { dirname, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { existsSync } from \"node:fs\";\n\ndeclare const Bun: unknown;\n\n/**\n * Get the directory of the current module\n *\n * @param meta - Pass `import.meta` from your module\n * @returns Absolute path to the directory containing the module\n *\n * @example\n * ```typescript\n * import { getModuleDir } from \"@agentxjs/common/path\";\n *\n * const __dirname = getModuleDir(import.meta);\n * ```\n */\nexport function getModuleDir(meta: ImportMeta): string {\n  // Bun has import.meta.dir\n  if ((meta as any).dir) {\n    return (meta as any).dir;\n  }\n  // Node.js: convert file:// URL to path\n  return dirname(fileURLToPath(meta.url));\n}\n\n/**\n * Get the root directory of the current package (where package.json is)\n *\n * @param meta - Pass `import.meta` from your module\n * @returns Absolute path to the package root\n *\n * @example\n * ```typescript\n * import { getPackageRoot } from \"@agentxjs/common/path\";\n *\n * const pkgRoot = getPackageRoot(import.meta);\n * // e.g., /Users/sean/AgentX/packages/queue\n * ```\n */\nexport function getPackageRoot(meta: ImportMeta): string {\n  const startDir = getModuleDir(meta);\n  return findUp(startDir, \"package.json\");\n}\n\n/**\n * Get the monorepo root directory (where pnpm-workspace.yaml or root package.json is)\n *\n * @param meta - Pass `import.meta` from your module\n * @returns Absolute path to the monorepo root\n *\n * @example\n * ```typescript\n * import { getMonorepoRoot } from \"@agentxjs/common/path\";\n *\n * const root = getMonorepoRoot(import.meta);\n * // e.g., /Users/sean/AgentX\n * ```\n */\nexport function getMonorepoRoot(meta: ImportMeta): string {\n  const startDir = getModuleDir(meta);\n\n  // Try common monorepo markers in order\n  const markers = [\n    \"pnpm-workspace.yaml\", // pnpm monorepo\n    \"pnpm-lock.yaml\", // pnpm\n    \"bun.lock\", // bun workspace\n    \"bun.lockb\", // bun workspace (binary)\n    \"package-lock.json\", // npm workspace\n    \"yarn.lock\", // yarn workspace\n  ];\n\n  for (const marker of markers) {\n    try {\n      return findUp(startDir, marker);\n    } catch {\n      // Try next marker\n    }\n  }\n\n  // Last resort: find root package.json\n  return findUp(startDir, \"package.json\");\n}\n\n/**\n * Resolve a path relative to the monorepo root\n *\n * @param meta - Pass `import.meta` from your module\n * @param paths - Path segments to resolve\n * @returns Absolute resolved path\n *\n * @example\n * ```typescript\n * import { resolveFromRoot } from \"@agentxjs/common/path\";\n *\n * const dataDir = resolveFromRoot(import.meta, \"data\");\n * // e.g., /Users/sean/AgentX/data\n *\n * const config = resolveFromRoot(import.meta, \"packages\", \"config\", \"settings.json\");\n * // e.g., /Users/sean/AgentX/packages/config/settings.json\n * ```\n */\nexport function resolveFromRoot(meta: ImportMeta, ...paths: string[]): string {\n  const root = getMonorepoRoot(meta);\n  return resolve(root, ...paths);\n}\n\n/**\n * Resolve a path relative to the current package root\n *\n * @param meta - Pass `import.meta` from your module\n * @param paths - Path segments to resolve\n * @returns Absolute resolved path\n *\n * @example\n * ```typescript\n * import { resolveFromPackage } from \"@agentxjs/common/path\";\n *\n * const testsDir = resolveFromPackage(import.meta, \"tests\");\n * // e.g., /Users/sean/AgentX/packages/queue/tests\n *\n * const fixtures = resolveFromPackage(import.meta, \"tests\", \"fixtures\", \"data.json\");\n * // e.g., /Users/sean/AgentX/packages/queue/tests/fixtures/data.json\n * ```\n */\nexport function resolveFromPackage(meta: ImportMeta, ...paths: string[]): string {\n  const pkgRoot = getPackageRoot(meta);\n  return resolve(pkgRoot, ...paths);\n}\n\n/**\n * Find a file by walking up the directory tree\n */\nfunction findUp(startDir: string, filename: string): string {\n  let current = startDir;\n  const root = resolve(\"/\");\n\n  while (current !== root) {\n    const candidate = resolve(current, filename);\n    if (existsSync(candidate)) {\n      return current;\n    }\n    const parent = dirname(current);\n    if (parent === current) break;\n    current = parent;\n  }\n\n  throw new Error(`Could not find ${filename} starting from ${startDir}`);\n}\n"
+  ],
+  "mappings": ";AAMA;AACA;AACA;AAiBO,SAAS,YAAY,CAAC,MAA0B;AAAA,EAErD,IAAK,KAAa,KAAK;AAAA,IACrB,OAAQ,KAAa;AAAA,EACvB;AAAA,EAEA,OAAO,QAAQ,cAAc,KAAK,GAAG,CAAC;AAAA;AAiBjC,SAAS,cAAc,CAAC,MAA0B;AAAA,EACvD,MAAM,WAAW,aAAa,IAAI;AAAA,EAClC,OAAO,OAAO,UAAU,cAAc;AAAA;AAiBjC,SAAS,eAAe,CAAC,MAA0B;AAAA,EACxD,MAAM,WAAW,aAAa,IAAI;AAAA,EAGlC,MAAM,UAAU;AAAA,IACd;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EAEA,WAAW,UAAU,SAAS;AAAA,IAC5B,IAAI;AAAA,MACF,OAAO,OAAO,UAAU,MAAM;AAAA,MAC9B,MAAM;AAAA,EAGV;AAAA,EAGA,OAAO,OAAO,UAAU,cAAc;AAAA;AAqBjC,SAAS,eAAe,CAAC,SAAqB,OAAyB;AAAA,EAC5E,MAAM,OAAO,gBAAgB,IAAI;AAAA,EACjC,OAAO,QAAQ,MAAM,GAAG,KAAK;AAAA;AAqBxB,SAAS,kBAAkB,CAAC,SAAqB,OAAyB;AAAA,EAC/E,MAAM,UAAU,eAAe,IAAI;AAAA,EACnC,OAAO,QAAQ,SAAS,GAAG,KAAK;AAAA;AAMlC,SAAS,MAAM,CAAC,UAAkB,UAA0B;AAAA,EAC1D,IAAI,UAAU;AAAA,EACd,MAAM,OAAO,QAAQ,GAAG;AAAA,EAExB,OAAO,YAAY,MAAM;AAAA,IACvB,MAAM,YAAY,QAAQ,SAAS,QAAQ;AAAA,IAC3C,IAAI,WAAW,SAAS,GAAG;AAAA,MACzB,OAAO;AAAA,IACT;AAAA,IACA,MAAM,SAAS,QAAQ,OAAO;AAAA,IAC9B,IAAI,WAAW;AAAA,MAAS;AAAA,IACxB,UAAU;AAAA,EACZ;AAAA,EAEA,MAAM,IAAI,MAAM,kBAAkB,0BAA0B,UAAU;AAAA;",
+  "debugId": "6C5E3AD0868C9DBF64756E2164756E21",
+  "names": []
+}

package/dist/sqlite/index.d.ts

@@ -0,0 +1,64 @@
+/**
+* SQLite Database Abstraction Types
+*
+* Unified interface for Node.js (node:sqlite) and Bun (bun:sqlite)
+*/
+/**
+* Query execution result
+*/
+interface RunResult {
+	/** Number of rows changed */
+	changes: number;
+	/** Last inserted row ID */
+	lastInsertRowid: number | bigint;
+}
+/**
+* Prepared statement
+*/
+interface Statement {
+	/** Execute statement with parameters, return result */
+	run(...params: unknown[]): RunResult;
+	/** Get single row */
+	get(...params: unknown[]): unknown;
+	/** Get all rows */
+	all(...params: unknown[]): unknown[];
+}
+/**
+* Database connection
+*/
+interface Database {
+	/** Execute raw SQL (no return value) */
+	exec(sql: string): void;
+	/** Prepare a statement for execution */
+	prepare(sql: string): Statement;
+	/** Close the database connection */
+	close(): void;
+}
+/**
+* Open a SQLite database
+*
+* Automatically detects runtime:
+* - Bun → uses bun:sqlite
+* - Node.js 22+ → uses node:sqlite
+*
+* @param path - Database file path (use ":memory:" for in-memory)
+* @returns Database instance
+*
+* @example
+* ```typescript
+* import { openDatabase } from "@agentxjs/common";
+*
+* const db = openDatabase("./data/app.db");
+* db.exec("CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY, name TEXT)");
+*
+* const stmt = db.prepare("INSERT INTO users (name) VALUES (?)");
+* stmt.run("Alice");
+*
+* const users = db.prepare("SELECT * FROM users").all();
+* console.log(users);
+*
+* db.close();
+* ```
+*/
+declare function openDatabase(path: string): Database;
+export { openDatabase, Statement, RunResult, Database };

package/dist/sqlite/index.js

@@ -0,0 +1,96 @@
+import { createRequire } from "node:module";
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/sqlite/database.ts
+import { dirname } from "node:path";
+import { mkdirSync, existsSync } from "node:fs";
+function ensureDir(path) {
+  if (path === ":memory:")
+    return;
+  const dir = dirname(path);
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+}
+function isBun() {
+  return typeof Bun !== "undefined";
+}
+function hasNodeSqlite() {
+  return typeof globalThis.process?.getBuiltinModule === "function" && globalThis.process.getBuiltinModule("node:sqlite") !== undefined;
+}
+function openDatabase(path) {
+  ensureDir(path);
+  if (isBun()) {
+    return openBunDatabase(path);
+  }
+  if (hasNodeSqlite()) {
+    return openNodeDatabase(path);
+  }
+  throw new Error("No SQLite runtime available. Requires Bun or Node.js 22+ with built-in sqlite.");
+}
+function openBunDatabase(path) {
+  const { Database: BunDatabase } = __require("bun:sqlite");
+  const db = new BunDatabase(path);
+  return {
+    exec(sql) {
+      db.exec(sql);
+    },
+    prepare(sql) {
+      const stmt = db.prepare(sql);
+      return {
+        run(...params) {
+          const result = stmt.run(...params);
+          return {
+            changes: result.changes,
+            lastInsertRowid: result.lastInsertRowid
+          };
+        },
+        get(...params) {
+          return stmt.get(...params);
+        },
+        all(...params) {
+          return stmt.all(...params);
+        }
+      };
+    },
+    close() {
+      db.close();
+    }
+  };
+}
+function openNodeDatabase(path) {
+  const nodeSqlite = globalThis.process.getBuiltinModule("node:sqlite");
+  const { DatabaseSync } = nodeSqlite;
+  const db = new DatabaseSync(path);
+  return {
+    exec(sql) {
+      db.exec(sql);
+    },
+    prepare(sql) {
+      const stmt = db.prepare(sql);
+      return {
+        run(...params) {
+          const result = stmt.run(...params);
+          return {
+            changes: result.changes,
+            lastInsertRowid: result.lastInsertRowid
+          };
+        },
+        get(...params) {
+          return stmt.get(...params);
+        },
+        all(...params) {
+          return stmt.all(...params);
+        }
+      };
+    },
+    close() {
+      db.close();
+    }
+  };
+}
+export {
+  openDatabase
+};
+
+//# debugId=E89B6E8118FDB35764756E2164756E21

package/dist/sqlite/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../src/sqlite/database.ts"],
+  "sourcesContent": [
+    "/**\n * SQLite Database Implementation\n *\n * Auto-detects runtime and uses:\n * - Bun: bun:sqlite (built-in)\n * - Node.js 22+: node:sqlite (built-in)\n */\n\nimport { dirname } from \"node:path\";\nimport { mkdirSync, existsSync } from \"node:fs\";\nimport type { Database, Statement, RunResult } from \"./types\";\n\ndeclare const Bun: unknown;\n\n/**\n * Ensure parent directory exists for database file\n */\nfunction ensureDir(path: string): void {\n  if (path === \":memory:\") return;\n  const dir = dirname(path);\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true });\n  }\n}\n\n/**\n * Detect if running in Bun\n */\nfunction isBun(): boolean {\n  return typeof Bun !== \"undefined\";\n}\n\n/**\n * Detect if Node.js has built-in SQLite (22+)\n */\nfunction hasNodeSqlite(): boolean {\n  return (\n    typeof globalThis.process?.getBuiltinModule === \"function\" &&\n    globalThis.process.getBuiltinModule(\"node:sqlite\") !== undefined\n  );\n}\n\n/**\n * Open a SQLite database\n *\n * Automatically detects runtime:\n * - Bun → uses bun:sqlite\n * - Node.js 22+ → uses node:sqlite\n *\n * @param path - Database file path (use \":memory:\" for in-memory)\n * @returns Database instance\n *\n * @example\n * ```typescript\n * import { openDatabase } from \"@agentxjs/common\";\n *\n * const db = openDatabase(\"./data/app.db\");\n * db.exec(\"CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY, name TEXT)\");\n *\n * const stmt = db.prepare(\"INSERT INTO users (name) VALUES (?)\");\n * stmt.run(\"Alice\");\n *\n * const users = db.prepare(\"SELECT * FROM users\").all();\n * console.log(users);\n *\n * db.close();\n * ```\n */\nexport function openDatabase(path: string): Database {\n  // Ensure parent directory exists\n  ensureDir(path);\n\n  if (isBun()) {\n    return openBunDatabase(path);\n  }\n\n  if (hasNodeSqlite()) {\n    return openNodeDatabase(path);\n  }\n\n  throw new Error(\"No SQLite runtime available. Requires Bun or Node.js 22+ with built-in sqlite.\");\n}\n\n/**\n * Open database using Bun's bun:sqlite\n */\nfunction openBunDatabase(path: string): Database {\n  // Dynamic require to avoid bundling issues\n\n  const { Database: BunDatabase } = require(\"bun:sqlite\");\n  const db = new BunDatabase(path);\n\n  return {\n    exec(sql: string): void {\n      db.exec(sql);\n    },\n\n    prepare(sql: string): Statement {\n      const stmt = db.prepare(sql);\n      return {\n        run(...params: unknown[]): RunResult {\n          const result = stmt.run(...params);\n          return {\n            changes: result.changes,\n            lastInsertRowid: result.lastInsertRowid,\n          };\n        },\n        get(...params: unknown[]): unknown {\n          return stmt.get(...params);\n        },\n        all(...params: unknown[]): unknown[] {\n          return stmt.all(...params);\n        },\n      };\n    },\n\n    close(): void {\n      db.close();\n    },\n  };\n}\n\n/**\n * Open database using Node.js node:sqlite\n */\nfunction openNodeDatabase(path: string): Database {\n  const nodeSqlite = globalThis.process.getBuiltinModule(\"node:sqlite\") as any;\n  const { DatabaseSync } = nodeSqlite;\n  const db = new DatabaseSync(path);\n\n  return {\n    exec(sql: string): void {\n      db.exec(sql);\n    },\n\n    prepare(sql: string): Statement {\n      const stmt = db.prepare(sql);\n      return {\n        run(...params: unknown[]): RunResult {\n          const result = stmt.run(...params);\n          return {\n            changes: result.changes,\n            lastInsertRowid: result.lastInsertRowid,\n          };\n        },\n        get(...params: unknown[]): unknown {\n          return stmt.get(...params);\n        },\n        all(...params: unknown[]): unknown[] {\n          return stmt.all(...params);\n        },\n      };\n    },\n\n    close(): void {\n      db.close();\n    },\n  };\n}\n"
+  ],
+  "mappings": ";;;;AAQA;AACA;AAQA,SAAS,SAAS,CAAC,MAAoB;AAAA,EACrC,IAAI,SAAS;AAAA,IAAY;AAAA,EACzB,MAAM,MAAM,QAAQ,IAAI;AAAA,EACxB,IAAI,CAAC,WAAW,GAAG,GAAG;AAAA,IACpB,UAAU,KAAK,EAAE,WAAW,KAAK,CAAC;AAAA,EACpC;AAAA;AAMF,SAAS,KAAK,GAAY;AAAA,EACxB,OAAO,OAAO,QAAQ;AAAA;AAMxB,SAAS,aAAa,GAAY;AAAA,EAChC,OACE,OAAO,WAAW,SAAS,qBAAqB,cAChD,WAAW,QAAQ,iBAAiB,aAAa,MAAM;AAAA;AA8BpD,SAAS,YAAY,CAAC,MAAwB;AAAA,EAEnD,UAAU,IAAI;AAAA,EAEd,IAAI,MAAM,GAAG;AAAA,IACX,OAAO,gBAAgB,IAAI;AAAA,EAC7B;AAAA,EAEA,IAAI,cAAc,GAAG;AAAA,IACnB,OAAO,iBAAiB,IAAI;AAAA,EAC9B;AAAA,EAEA,MAAM,IAAI,MAAM,gFAAgF;AAAA;AAMlG,SAAS,eAAe,CAAC,MAAwB;AAAA,EAG/C,QAAQ,UAAU;AAAA,EAClB,MAAM,KAAK,IAAI,YAAY,IAAI;AAAA,EAE/B,OAAO;AAAA,IACL,IAAI,CAAC,KAAmB;AAAA,MACtB,GAAG,KAAK,GAAG;AAAA;AAAA,IAGb,OAAO,CAAC,KAAwB;AAAA,MAC9B,MAAM,OAAO,GAAG,QAAQ,GAAG;AAAA,MAC3B,OAAO;AAAA,QACL,GAAG,IAAI,QAA8B;AAAA,UACnC,MAAM,SAAS,KAAK,IAAI,GAAG,MAAM;AAAA,UACjC,OAAO;AAAA,YACL,SAAS,OAAO;AAAA,YAChB,iBAAiB,OAAO;AAAA,UAC1B;AAAA;AAAA,QAEF,GAAG,IAAI,QAA4B;AAAA,UACjC,OAAO,KAAK,IAAI,GAAG,MAAM;AAAA;AAAA,QAE3B,GAAG,IAAI,QAA8B;AAAA,UACnC,OAAO,KAAK,IAAI,GAAG,MAAM;AAAA;AAAA,MAE7B;AAAA;AAAA,IAGF,KAAK,GAAS;AAAA,MACZ,GAAG,MAAM;AAAA;AAAA,EAEb;AAAA;AAMF,SAAS,gBAAgB,CAAC,MAAwB;AAAA,EAChD,MAAM,aAAa,WAAW,QAAQ,iBAAiB,aAAa;AAAA,EACpE,QAAQ,iBAAiB;AAAA,EACzB,MAAM,KAAK,IAAI,aAAa,IAAI;AAAA,EAEhC,OAAO;AAAA,IACL,IAAI,CAAC,KAAmB;AAAA,MACtB,GAAG,KAAK,GAAG;AAAA;AAAA,IAGb,OAAO,CAAC,KAAwB;AAAA,MAC9B,MAAM,OAAO,GAAG,QAAQ,GAAG;AAAA,MAC3B,OAAO;AAAA,QACL,GAAG,IAAI,QAA8B;AAAA,UACnC,MAAM,SAAS,KAAK,IAAI,GAAG,MAAM;AAAA,UACjC,OAAO;AAAA,YACL,SAAS,OAAO;AAAA,YAChB,iBAAiB,OAAO;AAAA,UAC1B;AAAA;AAAA,QAEF,GAAG,IAAI,QAA4B;AAAA,UACjC,OAAO,KAAK,IAAI,GAAG,MAAM;AAAA;AAAA,QAE3B,GAAG,IAAI,QAA8B;AAAA,UACnC,OAAO,KAAK,IAAI,GAAG,MAAM;AAAA;AAAA,MAE7B;AAAA;AAAA,IAGF,KAAK,GAAS;AAAA,MACZ,GAAG,MAAM;AAAA;AAAA,EAEb;AAAA;",
+  "debugId": "E89B6E8118FDB35764756E2164756E21",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentxjs/common",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "Common utilities for AgentX platform - Logger facade and shared infrastructure",
   "keywords": [
     "agentx",
@@ -24,6 +24,14 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./sqlite": {
+      "types": "./dist/sqlite/index.d.ts",
+      "default": "./dist/sqlite/index.js"
+    },
+    "./path": {
+      "types": "./dist/path/index.d.ts",
+      "default": "./dist/path/index.js"
     }
   },
   "files": [
@@ -37,7 +45,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@agentxjs/types": "^1.8.0"
+    "@agentxjs/types": "^1.9.0"
   },
   "devDependencies": {},
   "publishConfig": {