@agentxjs/node-platform 2.0.0

package/dist/index.d.ts

@@ -0,0 +1,140 @@
+import { AgentXPlatform } from '@agentxjs/core/runtime';
+import { LoggerFactory, LogLevel, Logger } from 'commonxjs/logger';
+export { Persistence, PersistenceDriver, SqliteDriverOptions, StorageContainerRepository, StorageImageRepository, StorageSessionRepository, createPersistence, memoryDriver, sqliteDriver } from './persistence/index.js';
+import { BashProvider, BashOptions, BashResult } from '@agentxjs/core/bash';
+export { OffsetGenerator, SqliteMessageQueue } from './mq/index.js';
+export { a as WebSocketConnection, W as WebSocketServer } from './WebSocketConnection-BUL85bFC.js';
+import 'unstorage';
+import '@agentxjs/core/persistence';
+import '@agentxjs/core/agent';
+import '@agentxjs/core/mq';
+import '@agentxjs/core/network';
+import 'ws';
+
+/**
+ * NodeBashProvider - Node.js implementation of BashProvider
+ *
+ * Uses execa for subprocess execution with proper timeout,
+ * error handling, and cross-platform shell support.
+ */
+
+/**
+ * NodeBashProvider - Executes shell commands via execa
+ */
+declare class NodeBashProvider implements BashProvider {
+    readonly type = "child-process";
+    execute(command: string, options?: BashOptions): Promise<BashResult>;
+}
+
+/**
+ * FileLoggerFactory - File-based logger for Node.js
+ *
+ * Writes logs to a file instead of console.
+ * Useful for TUI applications where console output interferes with the UI.
+ *
+ * Usage:
+ *   tail -f .agentx/logs/app.log
+ */
+
+/**
+ * FileLoggerFactory options
+ */
+interface FileLoggerFactoryOptions {
+    /**
+     * Directory for log files
+     */
+    logDir: string;
+    /**
+     * Log level
+     * @default "debug"
+     */
+    level?: LogLevel;
+    /**
+     * Log file name
+     * @default "app.log"
+     */
+    filename?: string;
+}
+/**
+ * FileLoggerFactory - Creates FileLogger instances
+ */
+declare class FileLoggerFactory implements LoggerFactory {
+    private readonly filePath;
+    private readonly level;
+    private readonly loggers;
+    constructor(options: FileLoggerFactoryOptions);
+    getLogger(name: string): Logger;
+}
+
+/**
+ * @agentxjs/node-platform
+ *
+ * Node.js platform for AgentX.
+ * Provides implementations for persistence, bash, and network.
+ *
+ * @example
+ * ```typescript
+ * import { createNodePlatform } from "@agentxjs/node-platform";
+ *
+ * const platform = await createNodePlatform({ dataPath: "./data" });
+ * ```
+ */
+
+/**
+ * Options for creating a Node platform
+ */
+interface NodePlatformOptions {
+    /**
+     * Base path for data storage
+     * @default "./data"
+     */
+    dataPath?: string;
+    /**
+     * Directory for log files
+     * If provided, enables file logging instead of console
+     * @example ".agentx/logs"
+     */
+    logDir?: string;
+    /**
+     * Log level
+     * @default "debug" for file logging, "info" for console
+     */
+    logLevel?: LogLevel;
+}
+/**
+ * Deferred platform config - resolved lazily
+ */
+interface DeferredPlatformConfig {
+    readonly __deferred: true;
+    readonly options: NodePlatformOptions;
+    resolve(): Promise<AgentXPlatform>;
+}
+/**
+ * Create a Node.js platform configuration (deferred initialization)
+ *
+ * Use this for function-style API. The platform is initialized lazily.
+ *
+ * @param options - Platform options
+ * @returns Deferred platform config
+ *
+ * @example
+ * ```typescript
+ * const server = await createServer({
+ *   platform: nodePlatform({ dataPath: "./data" }),
+ * });
+ * ```
+ */
+declare function nodePlatform(options?: NodePlatformOptions): DeferredPlatformConfig;
+/**
+ * Create a Node.js platform for AgentX (immediate initialization)
+ *
+ * @param options - Platform options
+ * @returns AgentXPlatform instance
+ */
+declare function createNodePlatform(options?: NodePlatformOptions): Promise<AgentXPlatform>;
+/**
+ * Check if value is a deferred platform config
+ */
+declare function isDeferredPlatform(value: unknown): value is DeferredPlatformConfig;
+
+export { type DeferredPlatformConfig, FileLoggerFactory, type FileLoggerFactoryOptions, NodeBashProvider, type NodePlatformOptions, createNodePlatform, isDeferredPlatform, nodePlatform };

package/dist/index.js

@@ -0,0 +1,223 @@
+import {
+  StorageContainerRepository,
+  StorageImageRepository,
+  StorageSessionRepository,
+  createPersistence,
+  memoryDriver,
+  sqliteDriver
+} from "./chunk-TXESAX3X.js";
+import {
+  OffsetGenerator,
+  SqliteMessageQueue
+} from "./chunk-PK2K7CCJ.js";
+import {
+  WebSocketConnection,
+  WebSocketServer
+} from "./chunk-BBZV6B5R.js";
+import "./chunk-V664KD3R.js";
+import "./chunk-DGUM43GV.js";
+
+// src/index.ts
+import { setLoggerFactory, ConsoleLogger } from "commonxjs/logger";
+import { EventBusImpl } from "@agentxjs/core/event";
+
+// src/bash/NodeBashProvider.ts
+import { execa } from "execa";
+import { createLogger } from "commonxjs/logger";
+var logger = createLogger("node-platform/NodeBashProvider");
+var DEFAULT_TIMEOUT = 3e4;
+var NodeBashProvider = class {
+  type = "child-process";
+  async execute(command, options) {
+    const timeout = options?.timeout ?? DEFAULT_TIMEOUT;
+    logger.debug("Executing command", {
+      command: command.substring(0, 100),
+      cwd: options?.cwd,
+      timeout
+    });
+    const result = await execa({
+      shell: true,
+      cwd: options?.cwd,
+      timeout,
+      env: options?.env ? { ...process.env, ...options.env } : void 0,
+      reject: false
+    })`${command}`;
+    logger.debug("Command completed", {
+      exitCode: result.exitCode,
+      stdoutLength: result.stdout.length,
+      stderrLength: result.stderr.length
+    });
+    return {
+      stdout: result.stdout,
+      stderr: result.stderr,
+      exitCode: result.exitCode ?? 1
+    };
+  }
+};
+
+// src/logger/FileLoggerFactory.ts
+import { appendFileSync, mkdirSync, existsSync } from "fs";
+import { dirname, join } from "path";
+var FileLogger = class {
+  name;
+  level;
+  timestamps;
+  filePath;
+  initialized = false;
+  constructor(name, filePath, options = {}) {
+    this.name = name;
+    this.filePath = filePath;
+    this.level = options.level ?? "debug";
+    this.timestamps = options.timestamps ?? true;
+  }
+  ensureDir() {
+    if (this.initialized) return;
+    const dir = dirname(this.filePath);
+    if (!existsSync(dir)) {
+      mkdirSync(dir, { recursive: true });
+    }
+    this.initialized = true;
+  }
+  debug(message, context) {
+    if (this.isDebugEnabled()) {
+      this.log("DEBUG", message, context);
+    }
+  }
+  info(message, context) {
+    if (this.isInfoEnabled()) {
+      this.log("INFO", message, context);
+    }
+  }
+  warn(message, context) {
+    if (this.isWarnEnabled()) {
+      this.log("WARN", message, context);
+    }
+  }
+  error(message, context) {
+    if (this.isErrorEnabled()) {
+      if (message instanceof Error) {
+        this.log("ERROR", message.message, { ...context, stack: message.stack });
+      } else {
+        this.log("ERROR", message, context);
+      }
+    }
+  }
+  isDebugEnabled() {
+    return this.getLevelValue(this.level) <= this.getLevelValue("debug");
+  }
+  isInfoEnabled() {
+    return this.getLevelValue(this.level) <= this.getLevelValue("info");
+  }
+  isWarnEnabled() {
+    return this.getLevelValue(this.level) <= this.getLevelValue("warn");
+  }
+  isErrorEnabled() {
+    return this.getLevelValue(this.level) <= this.getLevelValue("error");
+  }
+  getLevelValue(level) {
+    const levels = {
+      debug: 0,
+      info: 1,
+      warn: 2,
+      error: 3,
+      silent: 4
+    };
+    return levels[level];
+  }
+  log(level, message, context) {
+    this.ensureDir();
+    const parts = [];
+    if (this.timestamps) {
+      parts.push((/* @__PURE__ */ new Date()).toISOString());
+    }
+    parts.push(level.padEnd(5));
+    parts.push(`[${this.name}]`);
+    parts.push(message);
+    let logLine = parts.join(" ");
+    if (context && Object.keys(context).length > 0) {
+      logLine += " " + JSON.stringify(context);
+    }
+    logLine += "\n";
+    try {
+      appendFileSync(this.filePath, logLine);
+    } catch {
+      process.stderr.write(`[FileLogger] Failed to write: ${logLine}`);
+    }
+  }
+};
+var FileLoggerFactory = class {
+  filePath;
+  level;
+  loggers = /* @__PURE__ */ new Map();
+  constructor(options) {
+    this.filePath = join(options.logDir, options.filename ?? "app.log");
+    this.level = options.level ?? "debug";
+  }
+  getLogger(name) {
+    if (this.loggers.has(name)) {
+      return this.loggers.get(name);
+    }
+    const logger2 = new FileLogger(name, this.filePath, {
+      level: this.level
+    });
+    this.loggers.set(name, logger2);
+    return logger2;
+  }
+};
+
+// src/index.ts
+import { join as join2 } from "path";
+function nodePlatform(options = {}) {
+  return {
+    __deferred: true,
+    options,
+    resolve: () => createNodePlatform(options)
+  };
+}
+async function createNodePlatform(options = {}) {
+  const dataPath = options.dataPath ?? "./data";
+  if (options.logDir) {
+    const loggerFactory = new FileLoggerFactory({
+      logDir: options.logDir,
+      level: options.logLevel ?? "debug"
+    });
+    setLoggerFactory(loggerFactory);
+  } else if (options.logLevel) {
+    setLoggerFactory({
+      getLogger: (name) => new ConsoleLogger(name, { level: options.logLevel })
+    });
+  }
+  const persistence = await createPersistence(sqliteDriver({ path: join2(dataPath, "agentx.db") }));
+  const bashProvider = new NodeBashProvider();
+  const eventBus = new EventBusImpl();
+  const { createNodeWebSocket } = await import("./WebSocketFactory-SDWPRZVB.js");
+  return {
+    containerRepository: persistence.containers,
+    imageRepository: persistence.images,
+    sessionRepository: persistence.sessions,
+    eventBus,
+    bashProvider,
+    webSocketFactory: createNodeWebSocket
+  };
+}
+function isDeferredPlatform(value) {
+  return typeof value === "object" && value !== null && "__deferred" in value && value.__deferred === true;
+}
+export {
+  FileLoggerFactory,
+  NodeBashProvider,
+  OffsetGenerator,
+  SqliteMessageQueue,
+  StorageContainerRepository,
+  StorageImageRepository,
+  StorageSessionRepository,
+  WebSocketConnection,
+  WebSocketServer,
+  createNodePlatform,
+  createPersistence,
+  isDeferredPlatform,
+  memoryDriver,
+  nodePlatform,
+  sqliteDriver
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/bash/NodeBashProvider.ts","../src/logger/FileLoggerFactory.ts"],"sourcesContent":["/**\n * @agentxjs/node-platform\n *\n * Node.js platform for AgentX.\n * Provides implementations for persistence, bash, and network.\n *\n * @example\n * ```typescript\n * import { createNodePlatform } from \"@agentxjs/node-platform\";\n *\n * const platform = await createNodePlatform({ dataPath: \"./data\" });\n * ```\n */\n\nimport type { AgentXPlatform } from \"@agentxjs/core/runtime\";\nimport type { LogLevel } from \"commonxjs/logger\";\nimport { setLoggerFactory, ConsoleLogger } from \"commonxjs/logger\";\nimport { EventBusImpl } from \"@agentxjs/core/event\";\nimport { createPersistence, sqliteDriver } from \"./persistence\";\nimport { NodeBashProvider } from \"./bash/NodeBashProvider\";\nimport { FileLoggerFactory } from \"./logger\";\nimport { join } from \"node:path\";\n\n/**\n * Options for creating a Node platform\n */\nexport interface NodePlatformOptions {\n  /**\n   * Base path for data storage\n   * @default \"./data\"\n   */\n  dataPath?: string;\n\n  /**\n   * Directory for log files\n   * If provided, enables file logging instead of console\n   * @example \".agentx/logs\"\n   */\n  logDir?: string;\n\n  /**\n   * Log level\n   * @default \"debug\" for file logging, \"info\" for console\n   */\n  logLevel?: LogLevel;\n}\n\n/**\n * Deferred platform config - resolved lazily\n */\nexport interface DeferredPlatformConfig {\n  readonly __deferred: true;\n  readonly options: NodePlatformOptions;\n  resolve(): Promise<AgentXPlatform>;\n}\n\n/**\n * Create a Node.js platform configuration (deferred initialization)\n *\n * Use this for function-style API. The platform is initialized lazily.\n *\n * @param options - Platform options\n * @returns Deferred platform config\n *\n * @example\n * ```typescript\n * const server = await createServer({\n *   platform: nodePlatform({ dataPath: \"./data\" }),\n * });\n * ```\n */\nexport function nodePlatform(options: NodePlatformOptions = {}): DeferredPlatformConfig {\n  return {\n    __deferred: true,\n    options,\n    resolve: () => createNodePlatform(options),\n  };\n}\n\n/**\n * Create a Node.js platform for AgentX (immediate initialization)\n *\n * @param options - Platform options\n * @returns AgentXPlatform instance\n */\nexport async function createNodePlatform(\n  options: NodePlatformOptions = {}\n): Promise<AgentXPlatform> {\n  const dataPath = options.dataPath ?? \"./data\";\n\n  // Configure logging\n  if (options.logDir) {\n    const loggerFactory = new FileLoggerFactory({\n      logDir: options.logDir,\n      level: options.logLevel ?? \"debug\",\n    });\n    setLoggerFactory(loggerFactory);\n  } else if (options.logLevel) {\n    setLoggerFactory({\n      getLogger: (name: string) => new ConsoleLogger(name, { level: options.logLevel }),\n    });\n  }\n\n  // Create persistence with SQLite\n  const persistence = await createPersistence(sqliteDriver({ path: join(dataPath, \"agentx.db\") }));\n\n  // Create bash provider\n  const bashProvider = new NodeBashProvider();\n\n  // Create event bus\n  const eventBus = new EventBusImpl();\n\n  // Create WebSocket factory (uses ws library for Node.js)\n  const { createNodeWebSocket } = await import(\"./network/WebSocketFactory\");\n\n  return {\n    containerRepository: persistence.containers,\n    imageRepository: persistence.images,\n    sessionRepository: persistence.sessions,\n    eventBus,\n    bashProvider,\n    webSocketFactory: createNodeWebSocket,\n  };\n}\n\n/**\n * Check if value is a deferred platform config\n */\nexport function isDeferredPlatform(value: unknown): value is DeferredPlatformConfig {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"__deferred\" in value &&\n    (value as DeferredPlatformConfig).__deferred === true\n  );\n}\n\n// Re-export persistence\nexport * from \"./persistence\";\n\n// Re-export bash\nexport { NodeBashProvider } from \"./bash/NodeBashProvider\";\n\n// Re-export mq\nexport { SqliteMessageQueue, OffsetGenerator } from \"./mq\";\n\n// Re-export network\nexport { WebSocketServer, WebSocketConnection } from \"./network\";\n\n// Re-export logger\nexport { FileLoggerFactory, type FileLoggerFactoryOptions } from \"./logger\";\n","/**\n * NodeBashProvider - Node.js implementation of BashProvider\n *\n * Uses execa for subprocess execution with proper timeout,\n * error handling, and cross-platform shell support.\n */\n\nimport { execa } from \"execa\";\nimport type { BashProvider, BashResult, BashOptions } from \"@agentxjs/core/bash\";\nimport { createLogger } from \"commonxjs/logger\";\n\nconst logger = createLogger(\"node-platform/NodeBashProvider\");\n\n/**\n * Default timeout: 30 seconds\n */\nconst DEFAULT_TIMEOUT = 30_000;\n\n/**\n * NodeBashProvider - Executes shell commands via execa\n */\nexport class NodeBashProvider implements BashProvider {\n  readonly type = \"child-process\";\n\n  async execute(command: string, options?: BashOptions): Promise<BashResult> {\n    const timeout = options?.timeout ?? DEFAULT_TIMEOUT;\n\n    logger.debug(\"Executing command\", {\n      command: command.substring(0, 100),\n      cwd: options?.cwd,\n      timeout,\n    });\n\n    const result = await execa({\n      shell: true,\n      cwd: options?.cwd,\n      timeout,\n      env: options?.env ? { ...process.env, ...options.env } : undefined,\n      reject: false,\n    })`${command}`;\n\n    logger.debug(\"Command completed\", {\n      exitCode: result.exitCode,\n      stdoutLength: result.stdout.length,\n      stderrLength: result.stderr.length,\n    });\n\n    return {\n      stdout: result.stdout,\n      stderr: result.stderr,\n      exitCode: result.exitCode ?? 1,\n    };\n  }\n}\n","/**\n * FileLoggerFactory - File-based logger for Node.js\n *\n * Writes logs to a file instead of console.\n * Useful for TUI applications where console output interferes with the UI.\n *\n * Usage:\n *   tail -f .agentx/logs/app.log\n */\n\nimport { appendFileSync, mkdirSync, existsSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport type { Logger, LoggerFactory, LogContext, LogLevel } from \"commonxjs/logger\";\n\nexport interface FileLoggerOptions {\n  level?: LogLevel;\n  timestamps?: boolean;\n}\n\nclass FileLogger implements Logger {\n  readonly name: string;\n  readonly level: LogLevel;\n  private readonly timestamps: boolean;\n  private readonly filePath: string;\n  private initialized = false;\n\n  constructor(name: string, filePath: string, options: FileLoggerOptions = {}) {\n    this.name = name;\n    this.filePath = filePath;\n    this.level = options.level ?? \"debug\";\n    this.timestamps = options.timestamps ?? true;\n  }\n\n  private ensureDir(): void {\n    if (this.initialized) return;\n    const dir = dirname(this.filePath);\n    if (!existsSync(dir)) {\n      mkdirSync(dir, { recursive: true });\n    }\n    this.initialized = 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    this.ensureDir();\n\n    const parts: string[] = [];\n\n    if (this.timestamps) {\n      parts.push(new Date().toISOString());\n    }\n\n    parts.push(level.padEnd(5));\n    parts.push(`[${this.name}]`);\n    parts.push(message);\n\n    let logLine = parts.join(\" \");\n\n    if (context && Object.keys(context).length > 0) {\n      logLine += \" \" + JSON.stringify(context);\n    }\n\n    logLine += \"\\n\";\n\n    try {\n      appendFileSync(this.filePath, logLine);\n    } catch {\n      // Fallback to stderr if file write fails\n      process.stderr.write(`[FileLogger] Failed to write: ${logLine}`);\n    }\n  }\n}\n\n/**\n * FileLoggerFactory options\n */\nexport interface FileLoggerFactoryOptions {\n  /**\n   * Directory for log files\n   */\n  logDir: string;\n\n  /**\n   * Log level\n   * @default \"debug\"\n   */\n  level?: LogLevel;\n\n  /**\n   * Log file name\n   * @default \"app.log\"\n   */\n  filename?: string;\n}\n\n/**\n * FileLoggerFactory - Creates FileLogger instances\n */\nexport class FileLoggerFactory implements LoggerFactory {\n  private readonly filePath: string;\n  private readonly level: LogLevel;\n  private readonly loggers: Map<string, FileLogger> = new Map();\n\n  constructor(options: FileLoggerFactoryOptions) {\n    this.filePath = join(options.logDir, options.filename ?? \"app.log\");\n    this.level = options.level ?? \"debug\";\n  }\n\n  getLogger(name: string): Logger {\n    if (this.loggers.has(name)) {\n      return this.loggers.get(name)!;\n    }\n\n    const logger = new FileLogger(name, this.filePath, {\n      level: this.level,\n    });\n\n    this.loggers.set(name, logger);\n    return logger;\n  }\n}\n"],"mappings":"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","names":["logger","join"]}

package/dist/mq/index.d.ts

@@ -0,0 +1,63 @@
+import { MessageQueue, QueueConfig, QueueEntry, Unsubscribe } from '@agentxjs/core/mq';
+
+/**
+ * SqliteMessageQueue - RxJS-based message queue with SQLite persistence
+ *
+ * - In-memory pub/sub using RxJS Subject (real-time)
+ * - SQLite persistence for recovery guarantee
+ * - Consumer offset tracking for at-least-once delivery
+ */
+
+/**
+ * SqliteMessageQueue implementation
+ */
+declare class SqliteMessageQueue implements MessageQueue {
+    private readonly subject;
+    private readonly offsetGen;
+    private readonly config;
+    private readonly db;
+    private cleanupTimer?;
+    private isClosed;
+    private constructor();
+    /**
+     * Create a new SqliteMessageQueue instance
+     */
+    static create(path: string, config?: QueueConfig): SqliteMessageQueue;
+    publish(topic: string, event: unknown): Promise<string>;
+    subscribe(topic: string, handler: (entry: QueueEntry) => void): Unsubscribe;
+    ack(consumerId: string, topic: string, offset: string): Promise<void>;
+    getOffset(consumerId: string, topic: string): Promise<string | null>;
+    recover(topic: string, afterOffset?: string, limit?: number): Promise<QueueEntry[]>;
+    close(): Promise<void>;
+    /**
+     * Cleanup old entries based on retention policy
+     */
+    private cleanup;
+}
+
+/**
+ * OffsetGenerator - Generates monotonically increasing offsets
+ *
+ * Format: "{timestamp_base36}-{sequence_padded}"
+ * Example: "lq5x4g2-0001"
+ *
+ * This format ensures:
+ * - Lexicographic ordering matches temporal ordering
+ * - Multiple events in same millisecond get unique offsets
+ * - Human-readable and compact
+ */
+declare class OffsetGenerator {
+    private lastTimestamp;
+    private sequence;
+    /**
+     * Generate a new offset
+     */
+    generate(): string;
+    /**
+     * Compare two offsets
+     * @returns negative if a < b, 0 if a == b, positive if a > b
+     */
+    static compare(a: string, b: string): number;
+}
+
+export { OffsetGenerator, SqliteMessageQueue };

package/dist/mq/index.js

@@ -0,0 +1,10 @@
+import {
+  OffsetGenerator,
+  SqliteMessageQueue
+} from "../chunk-PK2K7CCJ.js";
+import "../chunk-DGUM43GV.js";
+export {
+  OffsetGenerator,
+  SqliteMessageQueue
+};
+//# sourceMappingURL=index.js.map

package/dist/mq/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/network/index.d.ts

@@ -0,0 +1,17 @@
+export { a as WebSocketConnection, W as WebSocketServer } from '../WebSocketConnection-BUL85bFC.js';
+import { WebSocketFactory } from '@agentxjs/core/network';
+import 'ws';
+
+/**
+ * Node.js WebSocket factory using the ws library
+ *
+ * Provides WebSocketFactory implementation for @agentxjs/core RpcClient.
+ * Browser environments use native WebSocket (the default in RpcClient).
+ */
+
+/**
+ * Create a WebSocket instance using the ws library (Node.js)
+ */
+declare const createNodeWebSocket: WebSocketFactory;
+
+export { createNodeWebSocket };

package/dist/network/index.js

@@ -0,0 +1,14 @@
+import {
+  WebSocketConnection,
+  WebSocketServer
+} from "../chunk-BBZV6B5R.js";
+import {
+  createNodeWebSocket
+} from "../chunk-V664KD3R.js";
+import "../chunk-DGUM43GV.js";
+export {
+  WebSocketConnection,
+  WebSocketServer,
+  createNodeWebSocket
+};
+//# sourceMappingURL=index.js.map

package/dist/network/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/persistence/index.d.ts

@@ -0,0 +1,175 @@
+import { Storage } from 'unstorage';
+import { ContainerRepository, ImageRepository, SessionRepository, ContainerRecord, ImageRecord, ImageMetadata, SessionRecord } from '@agentxjs/core/persistence';
+import { Message } from '@agentxjs/core/agent';
+
+/**
+ * Persistence Types for Node Provider
+ */
+
+/**
+ * Persistence driver interface
+ *
+ * Each driver must implement this interface.
+ * The createStorage() method is called once during initialization.
+ */
+interface PersistenceDriver {
+    /**
+     * Create the underlying storage instance
+     */
+    createStorage(): Promise<Storage>;
+}
+/**
+ * Persistence - Aggregated repositories
+ */
+interface Persistence {
+    readonly containers: ContainerRepository;
+    readonly images: ImageRepository;
+    readonly sessions: SessionRepository;
+}
+
+/**
+ * Persistence - Core persistence implementation
+ *
+ * Creates a Persistence instance from a driver.
+ * Each driver provides a createStorage() method that returns an unstorage Storage instance.
+ */
+
+/**
+ * Create a Persistence instance from a driver
+ *
+ * @param driver - The persistence driver to use
+ * @returns Promise<Persistence> instance
+ *
+ * @example
+ * ```typescript
+ * import { createPersistence, memoryDriver } from "@agentxjs/node-platform/persistence";
+ *
+ * const persistence = await createPersistence(memoryDriver());
+ * ```
+ */
+declare function createPersistence(driver: PersistenceDriver): Promise<Persistence>;
+
+/**
+ * SQLite Driver - SQLite database storage
+ *
+ * Uses commonxjs SQLite abstraction with automatic runtime detection:
+ * - Bun: uses bun:sqlite (built-in)
+ * - Node.js 22+: uses node:sqlite (built-in)
+ *
+ * @example
+ * ```typescript
+ * import { createPersistence, sqliteDriver } from "@agentxjs/node-platform/persistence";
+ *
+ * const persistence = await createPersistence(
+ *   sqliteDriver({ path: "./data/agentx.db" })
+ * );
+ * ```
+ */
+
+interface SqliteDriverOptions {
+    /**
+     * Path to SQLite database file
+     * @example "./data/agentx.db"
+     */
+    path: string;
+}
+/**
+ * Create a SQLite driver
+ *
+ * @param options - Driver options
+ */
+declare function sqliteDriver(options: SqliteDriverOptions): PersistenceDriver;
+
+/**
+ * Memory Driver - In-memory storage
+ *
+ * Useful for testing and development.
+ * Data is lost when the process exits.
+ *
+ * @example
+ * ```typescript
+ * import { createPersistence, memoryDriver } from "@agentxjs/node-platform/persistence";
+ *
+ * const persistence = await createPersistence(memoryDriver());
+ * ```
+ */
+
+/**
+ * Create a memory driver
+ */
+declare function memoryDriver(): PersistenceDriver;
+
+/**
+ * StorageContainerRepository - unstorage-based ContainerRepository
+ *
+ * Uses unstorage for backend-agnostic storage (Memory, Redis, SQLite, etc.)
+ */
+
+/**
+ * StorageContainerRepository - unstorage implementation
+ */
+declare class StorageContainerRepository implements ContainerRepository {
+    private readonly storage;
+    constructor(storage: Storage);
+    private key;
+    saveContainer(record: ContainerRecord): Promise<void>;
+    findContainerById(containerId: string): Promise<ContainerRecord | null>;
+    findAllContainers(): Promise<ContainerRecord[]>;
+    deleteContainer(containerId: string): Promise<void>;
+    containerExists(containerId: string): Promise<boolean>;
+}
+
+/**
+ * StorageImageRepository - unstorage-based ImageRepository
+ *
+ * Uses unstorage for backend-agnostic storage (Memory, Redis, SQLite, etc.)
+ */
+
+/**
+ * StorageImageRepository - unstorage implementation
+ */
+declare class StorageImageRepository implements ImageRepository {
+    private readonly storage;
+    constructor(storage: Storage);
+    private key;
+    private nameIndexKey;
+    private containerIndexKey;
+    saveImage(record: ImageRecord): Promise<void>;
+    findImageById(imageId: string): Promise<ImageRecord | null>;
+    findAllImages(): Promise<ImageRecord[]>;
+    findImagesByName(name: string): Promise<ImageRecord[]>;
+    findImagesByContainerId(containerId: string): Promise<ImageRecord[]>;
+    deleteImage(imageId: string): Promise<void>;
+    imageExists(imageId: string): Promise<boolean>;
+    updateMetadata(imageId: string, metadata: Partial<ImageMetadata>): Promise<void>;
+}
+
+/**
+ * StorageSessionRepository - unstorage-based SessionRepository
+ *
+ * Uses unstorage for backend-agnostic storage (Memory, Redis, SQLite, etc.)
+ */
+
+/**
+ * StorageSessionRepository - unstorage implementation
+ */
+declare class StorageSessionRepository implements SessionRepository {
+    private readonly storage;
+    constructor(storage: Storage);
+    private key;
+    private messagesKey;
+    private imageIndexKey;
+    private containerIndexKey;
+    saveSession(record: SessionRecord): Promise<void>;
+    findSessionById(sessionId: string): Promise<SessionRecord | null>;
+    findSessionByImageId(imageId: string): Promise<SessionRecord | null>;
+    findSessionsByContainerId(containerId: string): Promise<SessionRecord[]>;
+    findAllSessions(): Promise<SessionRecord[]>;
+    deleteSession(sessionId: string): Promise<void>;
+    sessionExists(sessionId: string): Promise<boolean>;
+    addMessage(sessionId: string, message: Message): Promise<void>;
+    getMessages(sessionId: string): Promise<Message[]>;
+    clearMessages(sessionId: string): Promise<void>;
+}
+
+export { type Persistence, type PersistenceDriver, type SqliteDriverOptions, StorageContainerRepository, StorageImageRepository, StorageSessionRepository, createPersistence, memoryDriver, sqliteDriver };