@nexus-cortex/core 4.26.0

package/dist/agents/AgentStore.d.ts

@@ -0,0 +1,172 @@
+/**
+ * AgentStore - Manages Task Agent profile definitions
+ *
+ * Loads, validates, and manages agent definitions from .cortex/agents/ directories.
+ * Supports project-level and personal (global) agents with hot-reload capability.
+ *
+ * @module agents/AgentStore
+ * @version 1.0.0
+ */
+import { EventEmitter } from 'events';
+import type { AgentDefinition, AgentPermissions } from '../orchestrator/SubAgentTypes.js';
+/**
+ * Agent store configuration
+ */
+export interface AgentStoreConfig {
+    /** Project .cortex/agents/ directory */
+    projectDir?: string;
+    /** Personal ~/.cortex/agents/ directory */
+    personalDir?: string;
+    /**
+     * Built-in / shipped .cortex/agents/ directory (the install root). Defaults
+     * to `$CORTEX_ROOT/.cortex/agents` so the agents that ship with the install
+     * are discoverable regardless of the current working directory. Lowest
+     * priority — project and personal agents override builtins by name.
+     */
+    builtinDir?: string;
+    /** Enable file watching for hot reload */
+    enableWatching?: boolean;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * Create options for new agents
+ */
+export interface CreateAgentOptions {
+    name: string;
+    description: string;
+    tools: string[] | 'all';
+    model: string;
+    systemPrompt?: string;
+    location?: 'project' | 'personal';
+    permissions?: AgentPermissions;
+}
+/**
+ * AgentStore class
+ */
+export declare class AgentStore extends EventEmitter {
+    private agents;
+    private agentFileCache;
+    private projectDir;
+    private personalDir;
+    private builtinDir?;
+    private enableWatching;
+    private debug;
+    private watchers;
+    private watcherControllers;
+    constructor(config?: AgentStoreConfig);
+    /**
+     * Initialize the store - load all agents
+     */
+    initialize(): Promise<void>;
+    /**
+     * Load all agents from both directories
+     */
+    loadAllAgents(): Promise<void>;
+    /**
+     * Load agents from a directory
+     */
+    private loadAgentsFromDir;
+    /**
+     * Load a single agent file
+     */
+    private loadAgentFile;
+    /**
+     * Build permissions with smart defaults based on tools
+     *
+     * - If no permissions specified, defaults to 'interactive' mode
+     * - Execution tools (Bash, Write, Edit) default to graylist
+     * - Read-only tools default to whitelist
+     */
+    private buildDefaultPermissions;
+    /**
+     * Parse agent file with YAML frontmatter
+     */
+    private parseAgentFile;
+    /**
+     * Simple YAML parser for agent frontmatter
+     *
+     * Handles basic key-value pairs, arrays, and nested permissions object
+     */
+    private parseSimpleYaml;
+    /**
+     * Helper to save permissions arrays
+     */
+    private savePermissionsArray;
+    /**
+     * Validate an agent definition
+     */
+    private validateAgent;
+    /**
+     * Get all loaded agents
+     */
+    getAll(): AgentDefinition[];
+    /**
+     * Get an agent by name
+     */
+    getAgent(name: string): AgentDefinition | undefined;
+    /**
+     * Check if an agent exists
+     */
+    hasAgent(name: string): boolean;
+    /**
+     * Get agents by location
+     */
+    getByLocation(location: 'project' | 'personal' | 'builtin'): AgentDefinition[];
+    /**
+     * Create a new agent
+     */
+    createAgent(options: CreateAgentOptions): Promise<AgentDefinition>;
+    /**
+     * Serialize permissions to YAML format
+     */
+    private serializePermissions;
+    /**
+     * Update an agent's content
+     */
+    updateAgent(name: string, content: string): Promise<void>;
+    /**
+     * Delete an agent
+     */
+    deleteAgent(name: string): Promise<void>;
+    /**
+     * Get raw file content for an agent
+     */
+    getAgentContent(name: string): Promise<string>;
+    /**
+     * Start watching directories for changes
+     */
+    private startWatching;
+    /**
+     * Add a change listener
+     */
+    onChange(listener: () => void): void;
+    /**
+     * Remove a change listener
+     */
+    removeChangeListener(listener: () => void): void;
+    /**
+     * Destroy the store and cleanup
+     */
+    destroy(): Promise<void>;
+    /**
+     * Debug logging
+     */
+    private log;
+    /**
+     * Get the project agents directory path
+     */
+    getProjectDir(): string;
+    /**
+     * Get the personal agents directory path
+     */
+    getPersonalDir(): string;
+}
+/**
+ * Create an AgentStore with default paths for a project
+ */
+export declare function createAgentStore(projectRoot: string, options?: {
+    enableWatching?: boolean;
+    debug?: boolean;
+}): AgentStore;
+//# sourceMappingURL=AgentStore.d.ts.map

package/dist/agents/AgentStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentStore.d.ts","sourceRoot":"","sources":["../../src/agents/AgentStore.ts"],"names":[],"mappings":"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"}