@agentxjs/runtime 0.1.1

package/dist/index.d.cts

@@ -0,0 +1,131 @@
+import { Persistence } from '@agentxjs/types';
+import { LLMProvider, ClaudeLLMConfig, Runtime } from '@agentxjs/types/runtime';
+import { Environment, Persistence as Persistence$1, ImageRepository, ContainerRepository, SessionRepository } from '@agentxjs/types/runtime/internal';
+import { Storage } from 'unstorage';
+
+/**
+ * createRuntime - Factory for creating Runtime instances
+ */
+
+/**
+ * Runtime configuration
+ */
+interface RuntimeConfig {
+    /**
+     * Persistence layer for data storage
+     */
+    persistence: Persistence;
+    /**
+     * LLM provider for AI model access
+     */
+    llmProvider: LLMProvider<ClaudeLLMConfig>;
+    /**
+     * Optional custom environment (for testing)
+     * If not provided, ClaudeEnvironment will be created from llmProvider
+     */
+    environment?: Environment;
+}
+/**
+ * Create a Runtime instance
+ *
+ * @param config - Runtime configuration
+ * @returns Runtime instance
+ */
+declare function createRuntime(config: RuntimeConfig): Runtime;
+
+/**
+ * PersistenceImpl - Multi-backend Persistence implementation
+ *
+ * Uses unstorage for backend-agnostic storage.
+ * Supports: Memory, FileSystem, Redis, MongoDB, SQLite, MySQL, PostgreSQL
+ *
+ * @example
+ * ```typescript
+ * // Memory (default)
+ * const persistence = await createPersistence();
+ *
+ * // SQLite
+ * const persistence = await createPersistence({
+ *   driver: "sqlite",
+ *   path: "./data.db",
+ * });
+ *
+ * // PostgreSQL
+ * const persistence = await createPersistence({
+ *   driver: "postgresql",
+ *   url: "postgres://user:pass@localhost:5432/agentx",
+ * });
+ *
+ * // Redis
+ * const persistence = await createPersistence({
+ *   driver: "redis",
+ *   url: "redis://localhost:6379",
+ * });
+ * ```
+ */
+
+/**
+ * Storage driver type
+ */
+type StorageDriver = "memory" | "fs" | "redis" | "mongodb" | "sqlite" | "mysql" | "postgresql";
+/**
+ * Persistence configuration
+ */
+interface PersistenceConfig {
+    /**
+     * Storage driver (default: "memory")
+     */
+    driver?: StorageDriver;
+    /**
+     * File path (for sqlite, fs drivers)
+     * @example "./data.db" for sqlite
+     * @example "./data" for fs
+     */
+    path?: string;
+    /**
+     * Connection URL (for redis, mongodb, mysql, postgresql)
+     * @example "redis://localhost:6379"
+     * @example "mongodb://localhost:27017/agentx"
+     * @example "mysql://user:pass@localhost:3306/agentx"
+     * @example "postgres://user:pass@localhost:5432/agentx"
+     */
+    url?: string;
+    /**
+     * Custom unstorage instance (advanced)
+     */
+    storage?: Storage;
+}
+/**
+ * PersistenceImpl - Multi-backend Persistence implementation
+ */
+declare class PersistenceImpl implements Persistence$1 {
+    readonly images: ImageRepository;
+    readonly containers: ContainerRepository;
+    readonly sessions: SessionRepository;
+    private readonly storage;
+    /**
+     * Private constructor - use createPersistence() factory function
+     */
+    private constructor();
+    /**
+     * Create a PersistenceImpl instance (async factory)
+     */
+    static create(config?: PersistenceConfig): Promise<PersistenceImpl>;
+    /**
+     * Get the underlying storage instance
+     */
+    getStorage(): Storage;
+    /**
+     * Dispose and cleanup resources
+     */
+    dispose(): Promise<void>;
+}
+/**
+ * Create Persistence instance (async)
+ *
+ * @param config - Configuration options
+ * @returns Promise<Persistence> instance
+ */
+declare function createPersistence(config?: PersistenceConfig): Promise<PersistenceImpl>;
+
+export { type PersistenceConfig, type RuntimeConfig, type StorageDriver, createPersistence, createRuntime };

package/dist/index.d.ts

@@ -0,0 +1,131 @@
+import { Persistence } from '@agentxjs/types';
+import { LLMProvider, ClaudeLLMConfig, Runtime } from '@agentxjs/types/runtime';
+import { Environment, Persistence as Persistence$1, ImageRepository, ContainerRepository, SessionRepository } from '@agentxjs/types/runtime/internal';
+import { Storage } from 'unstorage';
+
+/**
+ * createRuntime - Factory for creating Runtime instances
+ */
+
+/**
+ * Runtime configuration
+ */
+interface RuntimeConfig {
+    /**
+     * Persistence layer for data storage
+     */
+    persistence: Persistence;
+    /**
+     * LLM provider for AI model access
+     */
+    llmProvider: LLMProvider<ClaudeLLMConfig>;
+    /**
+     * Optional custom environment (for testing)
+     * If not provided, ClaudeEnvironment will be created from llmProvider
+     */
+    environment?: Environment;
+}
+/**
+ * Create a Runtime instance
+ *
+ * @param config - Runtime configuration
+ * @returns Runtime instance
+ */
+declare function createRuntime(config: RuntimeConfig): Runtime;
+
+/**
+ * PersistenceImpl - Multi-backend Persistence implementation
+ *
+ * Uses unstorage for backend-agnostic storage.
+ * Supports: Memory, FileSystem, Redis, MongoDB, SQLite, MySQL, PostgreSQL
+ *
+ * @example
+ * ```typescript
+ * // Memory (default)
+ * const persistence = await createPersistence();
+ *
+ * // SQLite
+ * const persistence = await createPersistence({
+ *   driver: "sqlite",
+ *   path: "./data.db",
+ * });
+ *
+ * // PostgreSQL
+ * const persistence = await createPersistence({
+ *   driver: "postgresql",
+ *   url: "postgres://user:pass@localhost:5432/agentx",
+ * });
+ *
+ * // Redis
+ * const persistence = await createPersistence({
+ *   driver: "redis",
+ *   url: "redis://localhost:6379",
+ * });
+ * ```
+ */
+
+/**
+ * Storage driver type
+ */
+type StorageDriver = "memory" | "fs" | "redis" | "mongodb" | "sqlite" | "mysql" | "postgresql";
+/**
+ * Persistence configuration
+ */
+interface PersistenceConfig {
+    /**
+     * Storage driver (default: "memory")
+     */
+    driver?: StorageDriver;
+    /**
+     * File path (for sqlite, fs drivers)
+     * @example "./data.db" for sqlite
+     * @example "./data" for fs
+     */
+    path?: string;
+    /**
+     * Connection URL (for redis, mongodb, mysql, postgresql)
+     * @example "redis://localhost:6379"
+     * @example "mongodb://localhost:27017/agentx"
+     * @example "mysql://user:pass@localhost:3306/agentx"
+     * @example "postgres://user:pass@localhost:5432/agentx"
+     */
+    url?: string;
+    /**
+     * Custom unstorage instance (advanced)
+     */
+    storage?: Storage;
+}
+/**
+ * PersistenceImpl - Multi-backend Persistence implementation
+ */
+declare class PersistenceImpl implements Persistence$1 {
+    readonly images: ImageRepository;
+    readonly containers: ContainerRepository;
+    readonly sessions: SessionRepository;
+    private readonly storage;
+    /**
+     * Private constructor - use createPersistence() factory function
+     */
+    private constructor();
+    /**
+     * Create a PersistenceImpl instance (async factory)
+     */
+    static create(config?: PersistenceConfig): Promise<PersistenceImpl>;
+    /**
+     * Get the underlying storage instance
+     */
+    getStorage(): Storage;
+    /**
+     * Dispose and cleanup resources
+     */
+    dispose(): Promise<void>;
+}
+/**
+ * Create Persistence instance (async)
+ *
+ * @param config - Configuration options
+ * @returns Promise<Persistence> instance
+ */
+declare function createPersistence(config?: PersistenceConfig): Promise<PersistenceImpl>;
+
+export { type PersistenceConfig, type RuntimeConfig, type StorageDriver, createPersistence, createRuntime };