@axiom-lattice/core 2.1.14 → 2.1.16

package/dist/index.d.mts

@@ -5,7 +5,7 @@ import { BaseChatModel, BaseChatModelCallOptions } from '@langchain/core/languag
 import { BaseLanguageModelInput } from '@langchain/core/language_models/base';
 import { CallbackManagerForLLMRun } from '@langchain/core/callbacks/manager';
 import { ChatResult } from '@langchain/core/outputs';
-import { LLMConfig, ToolConfig, ToolExecutor, AgentConfig, GraphBuildOptions, MessageChunk, QueueLatticeProtocol, QueueConfig, QueueClient, QueueResult, ScheduleLatticeProtocol, ScheduleConfig, ScheduleClient, ScheduleStorage, TaskHandler, ScheduleOnceOptions, ScheduleCronOptions, ScheduledTaskDefinition, ScheduledTaskStatus, ScheduleExecutionType, ThreadStore, AssistantStore, Thread, CreateThreadRequest, Assistant, CreateAssistantRequest } from '@axiom-lattice/protocols';
+import { LLMConfig, ToolConfig, ToolExecutor, AgentConfig, GraphBuildOptions, MessageChunk, QueueLatticeProtocol, QueueConfig, QueueClient, QueueResult, ScheduleLatticeProtocol, ScheduleConfig, ScheduleClient, ScheduleStorage, TaskHandler, ScheduleOnceOptions, ScheduleCronOptions, ScheduledTaskDefinition, ScheduledTaskStatus, ScheduleExecutionType, ThreadStore, AssistantStore, SkillStore, Thread, CreateThreadRequest, Assistant, CreateAssistantRequest, Skill, CreateSkillRequest, LoggerLatticeProtocol, LoggerConfig, LoggerClient, LoggerContext, SkillConfig, SkillClient } from '@axiom-lattice/protocols';
 import * as protocols from '@axiom-lattice/protocols';
 export { protocols as Protocols };
 export { AgentConfig, AgentType, GraphBuildOptions, MemoryType } from '@axiom-lattice/protocols';
@@ -1179,6 +1179,7 @@ declare function describeCronExpression(expression: string): string;
 type StoreTypeMap = {
     thread: ThreadStore;
     assistant: AssistantStore;
+    skill: SkillStore;
 };
 /**
  * Store type keys
@@ -1361,6 +1362,99 @@ declare class InMemoryAssistantStore implements AssistantStore {
     clear(): void;
 }
 
+/**
+ * FileSystemSkillStore
+ *
+ * Filesystem-based implementation of SkillStore
+ * Stores each skill as a Markdown file with YAML frontmatter
+ */
+
+/**
+ * FileSystemSkillStore options
+ */
+interface FileSystemSkillStoreOptions {
+    /**
+     * Root directory path for storing skills
+     * Can be absolute or relative path (relative to current working directory)
+     * @default "lattice_store/skills"
+     */
+    rootDir?: string;
+}
+/**
+ * Filesystem-based implementation of SkillStore
+ */
+declare class FileSystemSkillStore implements SkillStore {
+    private rootDir;
+    constructor(options?: FileSystemSkillStoreOptions);
+    /**
+     * Ensure the root directory exists
+     */
+    private ensureDirectoryExists;
+    /**
+     * Get directory path for a skill name
+     * Name is used as the directory name, and SKILL.md is the fixed filename
+     */
+    private getSkillDirectoryPath;
+    /**
+     * Get file path for a skill name
+     * File is always named SKILL.md inside the name directory
+     */
+    private getSkillFilePath;
+    /**
+     * Read skill from file
+     * Uses name as the directory name and reads SKILL.md from it
+     */
+    private readSkillFile;
+    /**
+     * Write skill to file
+     * Creates directory with name and writes SKILL.md inside it
+     */
+    private writeSkillFile;
+    /**
+     * Get all skills
+     */
+    getAllSkills(): Promise<Skill[]>;
+    /**
+     * Get skill by ID
+     * ID should equal name (name is used for path addressing)
+     */
+    getSkillById(id: string): Promise<Skill | null>;
+    /**
+     * Create a new skill
+     * id should equal name (name is used for path addressing)
+     */
+    createSkill(id: string, data: CreateSkillRequest): Promise<Skill>;
+    /**
+     * Update an existing skill
+     */
+    updateSkill(id: string, updates: Partial<CreateSkillRequest>): Promise<Skill | null>;
+    /**
+     * Delete a skill by ID
+     * Deletes the entire directory (name is the directory name)
+     */
+    deleteSkill(id: string): Promise<boolean>;
+    /**
+     * Check if skill exists
+     */
+    hasSkill(id: string): Promise<boolean>;
+    /**
+     * Search skills by metadata
+     */
+    searchByMetadata(metadataKey: string, metadataValue: string): Promise<Skill[]>;
+    /**
+     * Filter skills by compatibility
+     */
+    filterByCompatibility(compatibility: string): Promise<Skill[]>;
+    /**
+     * Filter skills by license
+     */
+    filterByLicense(license: string): Promise<Skill[]>;
+    /**
+     * Get sub-skills of a parent skill
+     */
+    getSubSkills(parentSkillName: string): Promise<Skill[]>;
+}
+
 /**
  * Embeddings Lattice Interface
  * Defines the structure of an embeddings lattice entry
@@ -1501,6 +1595,287 @@ declare const registerVectorStoreLattice: (key: string, vectorStore: VectorStore
 declare const getVectorStoreLattice: (key: string) => VectorStoreLatticeInterface;
 declare const getVectorStoreClient: (key: string) => VectorStore;
 
+/**
+ * LoggerLatticeManager
+ *
+ * Logger Lattice manager for registering and managing logger services
+ */
+
+/**
+ * Logger Lattice interface
+ */
+interface LoggerLattice extends LoggerLatticeProtocol {
+    key: string;
+    config: LoggerConfig;
+    client: LoggerLatticeProtocol["client"];
+}
+/**
+ * LoggerLatticeManager - Singleton logger Lattice manager
+ * Responsible for registering and managing various logger service Lattices
+ */
+declare class LoggerLatticeManager extends BaseLatticeManager<LoggerLattice> {
+    private static _instance;
+    /**
+     * Get LoggerLatticeManager singleton instance
+     */
+    static getInstance(): LoggerLatticeManager;
+    /**
+     * Get Lattice type prefix
+     */
+    protected getLatticeType(): string;
+    /**
+     * Register logger Lattice
+     * @param key Lattice key name
+     * @param config Logger configuration
+     * @param client Optional logger client. If not provided, will create based on config type.
+     */
+    registerLattice(key: string, config: LoggerConfig, client?: LoggerClient): void;
+    /**
+     * Get LoggerLattice
+     * @param key Lattice key name
+     */
+    getLoggerLattice(key: string): LoggerLattice;
+    /**
+     * Get all Lattices
+     */
+    getAllLattices(): LoggerLattice[];
+    /**
+     * Check if Lattice exists
+     * @param key Lattice key name
+     */
+    hasLattice(key: string): boolean;
+    /**
+     * Remove Lattice
+     * @param key Lattice key name
+     */
+    removeLattice(key: string): boolean;
+    /**
+     * Clear all Lattices
+     */
+    clearLattices(): void;
+    /**
+     * Get Lattice count
+     */
+    getLatticeCount(): number;
+    /**
+     * Get Lattice key list
+     */
+    getLatticeKeys(): string[];
+}
+declare const loggerLatticeManager: LoggerLatticeManager;
+declare const registerLoggerLattice: (key: string, config: LoggerConfig, client?: LoggerClient) => void;
+declare const getLoggerLattice: (key: string) => LoggerLattice;
+
+/**
+ * PinoLoggerClient
+ *
+ * Pino-based logger client implementation
+ */
+
+/**
+ * Pino-based logger client implementation
+ * Supports custom file paths and pino configurations
+ */
+declare class PinoLoggerClient implements LoggerClient {
+    private pinoLogger;
+    private config;
+    private context;
+    constructor(config: LoggerConfig);
+    /**
+     * Determine if file logging should be used
+     */
+    private shouldUseFileLogging;
+    /**
+     * Get file options from config
+     */
+    private getFileOptions;
+    /**
+     * Get contextual logger with merged context
+     */
+    private getContextualLogger;
+    info(msg: string, obj?: object): void;
+    error(msg: string, obj?: object | Error): void;
+    warn(msg: string, obj?: object): void;
+    debug(msg: string, obj?: object): void;
+    updateContext(context: Partial<LoggerContext>): void;
+    child(options: Partial<LoggerConfig>): LoggerClient;
+}
+
+/**
+ * ConsoleLoggerClient
+ *
+ * Simple console-based logger client implementation
+ */
+
+/**
+ * Console-based logger client implementation
+ */
+declare class ConsoleLoggerClient implements LoggerClient {
+    private config;
+    private context;
+    constructor(config: LoggerConfig);
+    private formatMessage;
+    info(msg: string, obj?: object): void;
+    error(msg: string, obj?: object | Error): void;
+    warn(msg: string, obj?: object): void;
+    debug(msg: string, obj?: object): void;
+    updateContext(context: Partial<LoggerContext>): void;
+    child(options: Partial<LoggerConfig>): LoggerClient;
+}
+
+/**
+ * SkillLatticeManager
+ *
+ * Skill Lattice manager for registering and managing skill components
+ */
+
+/**
+ * Skill Lattice interface
+ */
+interface SkillLattice {
+    key: string;
+    config: SkillConfig;
+    client: SkillClient | null;
+}
+/**
+ * SkillLatticeManager - Singleton skill Lattice manager
+ * Responsible for registering and managing various skill Lattices
+ */
+declare class SkillLatticeManager extends BaseLatticeManager<SkillLattice> {
+    private static _instance;
+    private storeKey?;
+    /**
+     * Get SkillLatticeManager singleton instance
+     */
+    static getInstance(): SkillLatticeManager;
+    /**
+     * Get Lattice type prefix
+     */
+    protected getLatticeType(): string;
+    /**
+     * Configure store for persistence
+     * @param storeKey Store key name registered in StoreLatticeManager
+     */
+    configureStore(storeKey: string): void;
+    /**
+     * Get configured store
+     * @returns SkillStore instance if configured, null otherwise
+     */
+    private getStore;
+    /**
+     * Inject store into client if client supports it
+     * @param client Skill client instance
+     * @param store Store instance to inject
+     */
+    private injectStoreIntoClient;
+    /**
+     * Register a skill Lattice
+     * @param key Lattice key name
+     * @param config Skill configuration
+     * @param client Optional skill client implementation
+     */
+    registerLattice(key: string, config: SkillConfig, client?: SkillClient): Promise<void>;
+    /**
+     * Get skill Lattice by key
+     * @param key Lattice key name
+     */
+    getSkillLattice(key: string): SkillLattice | undefined;
+    /**
+     * Get all skill Lattices from store
+     * Always reads from the configured store and merges with in-memory clients
+     */
+    getAllLattices(): Promise<SkillLattice[]>;
+    /**
+     * Check if Lattice exists
+     * @param key Lattice key name
+     */
+    hasLattice(key: string): boolean;
+    /**
+     * Remove Lattice
+     * @param key Lattice key name
+     */
+    removeLattice(key: string): Promise<boolean>;
+    /**
+     * Clear all Lattices
+     */
+    clearLattices(): void;
+    /**
+     * Get Lattice count
+     */
+    getLatticeCount(): number;
+    /**
+     * Get Lattice key name list
+     */
+    getLatticeKeys(): string[];
+    /**
+     * Get skill configuration
+     * @param key Lattice key name
+     */
+    getSkillConfig(key: string): SkillConfig;
+    /**
+     * Get skill client
+     * Ensures client has store access if store is configured
+     * @param key Lattice key name
+     */
+    getSkillClient(key: string): SkillClient | null;
+    /**
+     * Get all skill configurations from store
+     * Always reads from the configured store, not from memory
+     */
+    getAllSkillConfigs(): Promise<SkillConfig[]>;
+    /**
+     * Search skills by metadata
+     * @param metadataKey Metadata key to search for
+     * @param metadataValue Metadata value to match
+     */
+    searchByMetadata(metadataKey: string, metadataValue: string): Promise<SkillLattice[]>;
+    /**
+     * Filter skills by compatibility
+     * @param compatibility Compatibility string to filter by
+     */
+    filterByCompatibility(compatibility: string): Promise<SkillLattice[]>;
+    /**
+     * Filter skills by license
+     * @param license License string to filter by
+     */
+    filterByLicense(license: string): Promise<SkillLattice[]>;
+    /**
+     * Load skills from configured store
+     * This method loads all skills from the store and registers them in memory
+     */
+    loadFromStore(): Promise<void>;
+    /**
+     * Update skill in store
+     * @param key Skill key
+     * @param updates Partial skill data to update
+     */
+    updateSkillInStore(key: string, updates: Partial<SkillConfig>): Promise<void>;
+}
+declare const skillLatticeManager: SkillLatticeManager;
+
+/**
+ * Skill name validator
+ * Validates skill names according to the specification:
+ * - 1-64 characters
+ * - Lowercase alphanumeric with single hyphen separators
+ * - Not start or end with -
+ * - Not contain consecutive --
+ * - Match the directory name that contains SKILL.md
+ * - Regex: ^[a-z0-9]+(-[a-z0-9]+)*$
+ */
+/**
+ * Validate skill name
+ * @param name Skill name to validate
+ * @returns true if valid, false otherwise
+ */
+declare function isValidSkillName(name: string): boolean;
+/**
+ * Validate skill name and throw error if invalid
+ * @param name Skill name to validate
+ * @throws Error if name is invalid
+ */
+declare function validateSkillName(name: string): void;
+
 /**
  * Event bus service
  * Used for event publishing and subscription between internal system components
@@ -1558,4 +1933,4 @@ declare class AgentManager {
 
 declare const AGENT_TASK_EVENT = "agent:execute";
 
-export { AGENT_TASK_EVENT, type AgentClient, type AgentLattice, AgentLatticeManager, AgentManager, type BufferStats, type Chunk, ChunkBuffer, ChunkBufferLatticeManager, type ColumnInfo, type CronFields, type DatabaseConfig, type DatabaseType, DefaultScheduleClient, type EmbeddingsLatticeInterface, EmbeddingsLatticeManager, type ISqlDatabase, InMemoryAssistantStore, InMemoryChunkBuffer, InMemoryThreadStore, MemoryLatticeManager, MemoryQueueClient, MemoryScheduleStorage, type ModelConfig, type ModelLatticeInterface, ModelLatticeManager, PostgresDatabase, type QueryResult, type QueueLattice, QueueLatticeManager, type ScheduleLattice, ScheduleLatticeManager, SqlDatabaseManager, type StoreLattice, StoreLatticeManager, type StoreType, type StoreTypeMap, type TableInfo, type TableSchema, type ThreadBuffer, type ThreadBufferConfig, ThreadStatus, type ToolDefinition, type ToolLattice, ToolLatticeManager, type VectorStoreLatticeInterface, VectorStoreLatticeManager, agentLatticeManager, describeCronExpression, embeddingsLatticeManager, eventBus, eventBus as eventBusDefault, getAgentClient, getAgentConfig, getAgentLattice, getAllAgentConfigs, getAllToolDefinitions, getCheckpointSaver, getChunkBuffer, getEmbeddingsClient, getEmbeddingsLattice, getModelLattice, getNextCronTime, getQueueLattice, getScheduleLattice, getStoreLattice, getToolClient, getToolDefinition, getToolLattice, getVectorStoreClient, getVectorStoreLattice, hasChunkBuffer, isValidCronExpression, modelLatticeManager, parseCronExpression, queueLatticeManager, registerAgentLattice, registerAgentLattices, registerCheckpointSaver, registerChunkBuffer, registerEmbeddingsLattice, registerModelLattice, registerQueueLattice, registerScheduleLattice, registerStoreLattice, registerToolLattice, registerVectorStoreLattice, scheduleLatticeManager, sqlDatabaseManager, storeLatticeManager, toolLatticeManager, validateAgentInput, validateToolInput, vectorStoreLatticeManager };
+export { AGENT_TASK_EVENT, type AgentClient, type AgentLattice, AgentLatticeManager, AgentManager, type BufferStats, type Chunk, ChunkBuffer, ChunkBufferLatticeManager, type ColumnInfo, ConsoleLoggerClient, type CronFields, type DatabaseConfig, type DatabaseType, DefaultScheduleClient, type EmbeddingsLatticeInterface, EmbeddingsLatticeManager, FileSystemSkillStore, type FileSystemSkillStoreOptions, type ISqlDatabase, InMemoryAssistantStore, InMemoryChunkBuffer, InMemoryThreadStore, type LoggerLattice, LoggerLatticeManager, MemoryLatticeManager, MemoryQueueClient, MemoryScheduleStorage, type ModelConfig, type ModelLatticeInterface, ModelLatticeManager, PinoLoggerClient, PostgresDatabase, type QueryResult, type QueueLattice, QueueLatticeManager, type ScheduleLattice, ScheduleLatticeManager, type SkillLattice, SkillLatticeManager, SqlDatabaseManager, type StoreLattice, StoreLatticeManager, type StoreType, type StoreTypeMap, type TableInfo, type TableSchema, type ThreadBuffer, type ThreadBufferConfig, ThreadStatus, type ToolDefinition, type ToolLattice, ToolLatticeManager, type VectorStoreLatticeInterface, VectorStoreLatticeManager, agentLatticeManager, describeCronExpression, embeddingsLatticeManager, eventBus, eventBus as eventBusDefault, getAgentClient, getAgentConfig, getAgentLattice, getAllAgentConfigs, getAllToolDefinitions, getCheckpointSaver, getChunkBuffer, getEmbeddingsClient, getEmbeddingsLattice, getLoggerLattice, getModelLattice, getNextCronTime, getQueueLattice, getScheduleLattice, getStoreLattice, getToolClient, getToolDefinition, getToolLattice, getVectorStoreClient, getVectorStoreLattice, hasChunkBuffer, isValidCronExpression, isValidSkillName, loggerLatticeManager, modelLatticeManager, parseCronExpression, queueLatticeManager, registerAgentLattice, registerAgentLattices, registerCheckpointSaver, registerChunkBuffer, registerEmbeddingsLattice, registerLoggerLattice, registerModelLattice, registerQueueLattice, registerScheduleLattice, registerStoreLattice, registerToolLattice, registerVectorStoreLattice, scheduleLatticeManager, skillLatticeManager, sqlDatabaseManager, storeLatticeManager, toolLatticeManager, validateAgentInput, validateSkillName, validateToolInput, vectorStoreLatticeManager };