matrix-for-agents 0.1.2__py3-none-any.whl

agentmatrix/core/loader_v1.py

@@ -0,0 +1,146 @@
+import yaml
+import importlib
+import os
+from typing import List, Any
+from dotenv import load_dotenv
+import json
+from ..backends.llm_client import LLMClient
+from ..core.cerebellum import Cerebellum 
+from ..core.log_util import AutoLoggerMixin
+
+
+class AgentLoader(AutoLoggerMixin):
+    def __init__(self, profile_path):
+        # Loader 持有运行时需要的公共资源 (如 LLM 客户端)
+        # 这样实例化 Agent 时可以注入进去
+        self.profile_path = profile_path
+        #从profile path 下加载 .env
+        #print(f"loading from : {profile_path}")
+        env_file = os.path.join(profile_path, ".env")
+        if not os.path.exists(env_file):
+            raise FileNotFoundError(f"环境变量文件不存在: {self.profile_path}")
+        
+        # 检查文件权限
+        if not os.access(env_file, os.R_OK):
+            raise PermissionError(f"没有读取文件的权限: {self.profile_path}")
+        
+
+        vars = load_dotenv(env_file)
+        #加载 profile_path 下的 llm_config.json 文件
+        llm_config_file = os.path.join(profile_path, "llm_config.json")
+        
+        
+    
+        with open(llm_config_file, 'r', encoding='utf-8') as f:
+            self.llm_config = json.load(f)
+
+        # === 关键检查：必须存在 default_slm 配置 ===
+        if "default_slm" not in self.llm_config:
+            raise ValueError("llm_config.json 中必须包含 'default_slm' 配置，用于驱动默认小脑。")
+
+        for config in self.llm_config.values():
+
+            if "API_KEY" in config:
+                api_key = config["API_KEY"]
+                if os.getenv(api_key) is not None:
+                    config["API_KEY"] = os.getenv(api_key)
+
+
+        prompts_path = os.path.join(self.profile_path, "prompts")
+        self.prompts = {}
+        for prompt_txt in os.listdir(prompts_path):
+            
+            if prompt_txt.endswith(".txt"):
+                self.logger.info(f">>> 加载Prompt模板 {prompt_txt}...")
+                with open(os.path.join(prompts_path, prompt_txt), "r", encoding='utf-8') as f:
+                    self.prompts[prompt_txt[:-4]] = f.read()
+
+        self.logger.info(self.prompts)
+
+        
+        
+
+
+
+    def load_from_file(self, file_path: str) -> Any:
+        """从 JSON 文件加载并实例化一个 Agent"""
+        self.logger.info(f">>> 加载Agent配置文件 {file_path}...")
+        with open(file_path, 'r', encoding='utf-8') as f:
+            profile = yaml.safe_load(f)
+
+        # 1. 解析实现类信息
+        module_name = profile["module"]
+        class_name = profile["class_name"]
+
+        #remove module_name and class_name from profile
+        del profile["module"]
+        del profile["class_name"]
+
+        # 2. 动态导入 (Reflection)
+        try:
+            module = importlib.import_module(module_name)
+            agent_class = getattr(module, class_name)
+        except (ImportError, AttributeError) as e:
+            raise ImportError(f"无法加载 Agent 类: {module_name}.{class_name}. 错误: {e}")
+
+        # 注入 prompt template, 默认是"base"
+        if "prompte_template" not in profile:
+            profile["prompt_template"] = "base"
+        prompt_template_name = profile.get("prompt_template")
+        self.logger.info(f">>> 加载Prompt模板 {prompt_template_name}...")
+        if prompt_template_name in self.prompts:
+            prompt = self.prompts[prompt_template_name]
+            profile["full_prompt"] = prompt
+        else:
+            raise ValueError(f"加载Agent {file_path} 失败，Prompt 模板 {prompt_template_name} 未找到。")
+
+        # 3. 实例化
+        agent_instance = agent_class(profile.copy())
+
+        # 4. 设置LLM backend
+        backend_model = agent_instance.backend_model
+        agent_instance.brain  = self._create_llm_client(backend_model)
+        print(f"Agent {agent_instance.name} brain set to {backend_model} / {backend_model}")
+        
+        # === 设置小脑 (Cerebellum) ===
+        cerebellum_config = profile.get("cerebellum")
+        slm_client = None
+        
+        if cerebellum_config:
+            # A. 如果 Agent 定义了自己的小脑模型
+            print(cerebellum_config)
+            slm_model = cerebellum_config.get("backend_model", "default_slm")
+            slm_client = self._create_llm_client(slm_model)
+            print(f"[{agent_instance.name}] Using custom SLM: {slm_model}")
+        else:
+            # B. 如果没定义，强制使用 default_slm
+            slm_client = self._create_llm_client("default_slm")
+            print(f"[{agent_instance.name}] Using system default SLM.")
+        
+        # 注入小脑
+        agent_instance.cerebellum = Cerebellum(slm_client, agent_instance.name)
+
+    
+        
+
+        return agent_instance
+
+    def _create_llm_client(self, model_name):
+        llm_config = self.llm_config[model_name]
+        url = llm_config['url']
+        api_key = llm_config['API_KEY']
+        model_name = llm_config['model_name']
+        llm_client = LLMClient(url,api_key, model_name)
+        return llm_client
+
+    def load_all(self) -> List[Any]:
+        agents = {}
+        
+        for filename in os.listdir(self.profile_path):
+            if filename.endswith(".yml"):
+                full_path = os.path.join(self.profile_path, filename)
+                print(f"Loading agent from {filename}...")
+                agent = self.load_from_file(full_path)
+                agents[agent.name] = agent
+                
+        return agents

agentmatrix/core/log_util.py

@@ -0,0 +1,158 @@
+import os
+import logging
+from logging.handlers import RotatingFileHandler
+from typing import Optional
+
+
+# 1. 定义过滤器：决定什么能上控制台
+class ConsoleDisplayFilter(logging.Filter):
+    def filter(self, record):
+        # 规则 A: 错误(ERROR/CRITICAL) 必须显示
+        if record.levelno >= logging.ERROR:
+            return True
+        
+        # 规则 B: 如果日志携带了 'echo' 标记且为 True，则显示
+        # 使用 getattr 安全获取，防止报错
+        if getattr(record, 'echo', False):
+            return True
+            
+        # 其他（普通的 INFO/DEBUG）都不显示
+        return False
+
+# ==========================================
+# 1. LogFactory: 负责干活（创建 Logger 和 Handler）
+# ==========================================
+class LogFactory:
+    _log_dir = "./logs"
+    _formatter = logging.Formatter(
+        '%(asctime)s - [%(threadName)s] - %(name)s - %(levelname)s - %(message)s'
+    )
+    _default_level = logging.INFO  # 全局默认日志级别
+
+    @classmethod
+    def set_log_dir(cls, path: str):
+        cls._log_dir = path
+        os.makedirs(cls._log_dir, exist_ok=True)
+
+    @classmethod
+    def set_level(cls, level: int):
+        """【新增】设置全局默认日志级别"""
+        cls._default_level = level
+
+    @classmethod
+    def get_logger(cls, logger_name: str, filename: str,level: int = None) -> logging.Logger:
+        if not os.path.exists(cls._log_dir):
+            os.makedirs(cls._log_dir, exist_ok=True)
+
+        logger = logging.getLogger(logger_name)
+        # 【关键修改】决定当前 logger 的级别
+        target_level = level if level is not None else cls._default_level
+        logger.setLevel(target_level)
+        logger.propagate = False
+
+        if logger.handlers:
+            return logger
+
+        # --- 1. 文件 Handler (保持不变: 收录所有 INFO+) ---
+        file_path = os.path.join(cls._log_dir, filename)
+        file_handler = RotatingFileHandler(
+            file_path, maxBytes=10*1024*1024, backupCount=5, encoding='utf-8'
+        )
+        file_handler.setLevel(logging.DEBUG) 
+        file_handler.setFormatter(cls._formatter)
+        logger.addHandler(file_handler)
+
+        # --- 2. 控制台 Handler (修改点) ---
+        console_handler = logging.StreamHandler()
+        
+        # 【关键点 1】: 将级别降低到 INFO，否则 INFO 级别的日志根本进不来
+        console_handler.setLevel(logging.INFO) 
+        
+        # 【关键点 2】: 添加过滤器，由过滤器来把关谁能显示
+        console_handler.addFilter(ConsoleDisplayFilter())
+        
+        console_handler.setFormatter(cls._formatter)
+        logger.addHandler(console_handler)
+
+        return logger
+
+
+# ==========================================
+# 2. AutoLoggerMixin: 负责决策（决定文件名）
+# ==========================================
+class AutoLoggerMixin:
+    """
+    智能日志 Mixin。
+    
+    优先级策略：
+    1. 如果设置了 _log_from_attr = "xxx"，则文件名取 self.xxx + ".log"
+    2. 如果设置了 _custom_log_filename = "yyy.log"，则文件名为 "yyy.log"
+    3. 默认使用 类名.log
+    """
+    
+    # 【配置项 1】指定从哪个实例属性获取名字 (例如 "name", "id")
+    _log_from_attr: Optional[str] = None
+    
+    # 【配置项 2】指定固定的文件名
+    _custom_log_filename: Optional[str] = None
+
+    _custom_log_level: Optional[int] = None
+
+    @property
+    def logger(self) -> logging.Logger:
+        # 懒加载：只有第一次调用时才初始化
+        if not hasattr(self, '_internal_logger'):
+            self._init_logger()
+        return self._internal_logger
+
+    def _init_logger(self):
+        filename = self._determine_log_filename()
+        
+        # 这里的 logger_name 很关键：
+        # 如果是基于实例属性（如name='ABC'），logger_name 最好也叫 'ABC'，
+        # 这样 logging 模块能正确区分不同的 logger 对象。
+        # 如果是基于类名，就用类名。
+        
+        # 为了保证唯一性，我们使用 "类名_文件名" 作为 logger 内部的 key
+        logger_name = f"{self.__class__.__name__}_{filename}"
+        
+        # 将 mixin 中定义的级别传给工厂
+        self._internal_logger = LogFactory.get_logger(
+            logger_name, 
+            filename, 
+            level=self._custom_log_level
+        )
+
+    def _determine_log_filename(self) -> str:
+        """核心逻辑：决定日志文件名"""
+        
+        # 策略 1: 基于实例属性 (例如 self.name)
+        if self._log_from_attr:
+            if hasattr(self, self._log_from_attr):
+                attr_value = getattr(self, self._log_from_attr)
+                # 简单的清理，防止文件名非法字符
+                safe_name = str(attr_value).strip().replace('/', '_').replace('\\', '_')
+                return f"{safe_name}.log"
+            else:
+                # 如果指定的属性不存在，回退到默认
+                print(f"[Warn] Attribute '{self._log_from_attr}' not found in {self}, fallback to class name.")
+
+        # 策略 2: 固定文件名
+        if self._custom_log_filename:
+            return self._custom_log_filename
+
+        # 策略 3: 默认类名
+        return f"{self.__class__.__name__}.log"
+
+    def echo(self, msg: str, *args, **kwargs):
+        """
+        专用方法：既写日志文件，也输出到控制台。
+        用法: self.echo("Server started on port %s", 8080)
+        """
+        # 自动注入 extra={'echo': True}
+        if 'extra' not in kwargs:
+            kwargs['extra'] = {}
+        kwargs['extra']['echo'] = True
+        
+        # 调用原生 logger
+        self.logger.info(msg, *args, **kwargs)

agentmatrix/core/message.py

@@ -0,0 +1,32 @@
+import uuid
+from dataclasses import dataclass, field
+from typing import Optional, Dict, Any
+from datetime import datetime
+import textwrap
+
+@dataclass
+class Email:
+    sender: str
+    recipient: str
+    subject: str
+    body: str
+    in_reply_to: Optional[str] = None  # 核心：引用链
+    id: str = field(default_factory=lambda: str(uuid.uuid4()))
+    timestamp: datetime = field(default_factory=datetime.now)
+    user_session_id: Optional[str] = None  # 用于区分不同用户会话
+    
+    def __repr__(self):
+        reply_mark = f" (Re: {self.in_reply_to[:8]})" if self.in_reply_to else ""
+        return f"<Email {self.id[:8]} From:{self.sender} To:{self.recipient}{reply_mark}>"
+
+    def __str__(self):
+        return textwrap.dedent(f"""
+            ==== Mail  ====
+            From: {self.sender}
+            To: {self.recipient}
+            Subject: {self.subject}
+            Date: {self.timestamp}   
+
+            {self.body}
+            ================
+        """)

agentmatrix/core/prompt_engine.py

@@ -0,0 +1,30 @@
+from jinja2 import Environment, FileSystemLoader
+
+class PromptEngine:
+    def __init__(self, profile_path="./profiles", prompt_path="./prompts"):
+        self.env = Environment(loader=FileSystemLoader(prompt_path))
+        # 预加载一些全局配置
+        self.global_context = {
+            "env_description": "Local Development Environment",
+            "core_value": "Reliability and Structure"
+        }
+
+    def render_system_prompt(self, agent_profile, team_manifests):
+        """
+        为指定 Agent 生成完整的 System Prompt
+        """
+        # 1. 选择模板：如果 profile 指定了模板则用指定的，否则根据角色判断
+        template_name = agent_profile.get("prompt_template", "base.j2")
+        template = self.env.get_template(template_name)
+
+        # 2. 准备数据
+        context = {
+            **self.global_context,
+            "agent_name": agent_profile["name"],
+            "agent_role": agent_profile.get("role", "Worker"),
+            "agent_description": agent_profile["description"],
+            "team_members": team_manifests, # 这是一个包含 name, desc, instructions 的列表
+        }
+
+        # 3. 渲染
+        return template.render(**context)

agentmatrix/core/runtime.py

@@ -0,0 +1,211 @@
+# runtime.py 或 snapshot_manager.py
+import json
+
+from datetime import datetime
+from ..core.message import Email
+from dataclasses import asdict
+from ..core.loader import AgentLoader
+import asyncio
+import os
+
+import chromadb
+
+from chromadb.config import Settings
+from ..agents.post_office import PostOffice
+from ..core.log_util import LogFactory, AutoLoggerMixin
+from ..db.vector_db import VectorDB
+
+
+from ..core.message import Email
+
+
+# all event format:
+# Who(event source)
+# Status(the status of the event source)
+# Even Type
+# Even Time
+# Event Content
+# Event Payload
+
+
+VECTOR_DB_COLLECTIONS_NAMES =["email", "notebook"]
+
+async def default_event_printer(event):
+    pass
+    #self.echo(event)
+
+class AgentMatrix(AutoLoggerMixin):
+    def __init__(self, agent_profile_path, matrix_path, async_event_call_back = default_event_printer):
+        # === 全局实例 ===
+        log_path = os.path.join(matrix_path,".matrix", "logs")
+        LogFactory.set_log_dir(log_path)
+        
+        self.async_event_call_back = async_event_call_back
+        self.agent_profile_path= agent_profile_path
+        
+        self.matrix_path = matrix_path
+
+        self.agents = None
+        self.post_office = None
+        self.post_office_task = None
+        self.running_agent_tasks = []
+        self.running = False
+        self.echo(">>> 初始化世界资源...")
+        self._prepare_world_resource()
+        self.echo(">>> 初始化Agents...")
+        self._prepare_agents()
+        self.echo(">>> 加载世界状态...")
+        self.load_matrix()
+    def json_serializer(self,obj):
+        """JSON serializer for objects not serializable by default json code"""
+        try:
+            if isinstance(obj, (datetime,)):
+                return obj.isoformat()
+            # 尝试获取对象的详细信息
+            obj_info = f"Type: {type(obj)}, Value: {str(obj)[:100]}, Dir: {[attr for attr in dir(obj) if not attr.startswith('_')][:5]}"
+            raise TypeError(f"Object of type {obj.__class__.__name__} is not JSON serializable\nObject info: {obj_info}")
+        except Exception as e:
+            raise TypeError(f"Error serializing object: {str(e)}\nObject info: {obj_info}")
+
+
+    #准备世界资源，如向量数据库等
+    def _prepare_world_resource(self):
+        
+        self.echo(">>> Loading Vector Database...")
+        chroma_path = os.path.join(self.matrix_path, ".matrix", "chroma_db")
+        self.vector_db = VectorDB(chroma_path, VECTOR_DB_COLLECTIONS_NAMES)
+        self.echo(">>> Vector Database Loaded.")
+        # 恢复 PostOffice 状态
+        self.post_office = PostOffice(self.matrix_path)
+        self.post_office.vector_db = self.vector_db
+        self.post_office_task = asyncio.create_task(self.post_office.run())
+        self.echo(">>> PostOffice Loaded and Running.")
+        
+    def _prepare_agents(self):
+        loader = AgentLoader(self.agent_profile_path)
+
+        # 3. 自动加载所有 Agent
+        self.agents = loader.load_all()
+        for agent in self.agents.values():
+            agent.async_event_call_back = self.async_event_call_back
+
+
+
+    async def save_matrix(self):
+        """一键休眠"""
+        self.echo(">>> 正在冻结世界...")
+        self.post_office.pause()
+        # 2. 取消所有正在运行的agent任务
+        for task in self.running_agent_tasks:
+            task.cancel()
+        # 3. 等待所有任务完成
+        if self.running_agent_tasks:
+            asyncio.gather(*self.running_agent_tasks, return_exceptions=True)
+        self.running_agent_tasks.clear()
+
+        # 4. 停止邮局任务
+        if self.post_office_task:
+            self.post_office_task.cancel()
+            try:
+                await self.post_office_task
+                #asyncio.get_event_loop().run_until_complete(self.post_office_task)
+            except asyncio.CancelledError:
+                pass
+            self.post_office_task = None
+        
+        world_state = {
+            "timestamp": str(datetime.now()),
+            "agents": {},
+            "post_office": []
+        }
+
+        # 1. 冻结所有 Agent
+        for agent in self.agents.values():
+            world_state["agents"][agent.name] = agent.dump_state()
+
+        # 2. 冻结邮局 (如果有还在路由的信)
+        # 逻辑同 Agent Inbox
+        po_queue = []
+        while not self.post_office.queue.empty():
+            email = self.post_office.queue.get_nowait()
+            po_queue.append(asdict(email))
+            self.post_office.queue.task_done()
+        world_state["post_office"] = po_queue
+        filepath = os.path.join(self.matrix_path, ".matrix", "matrix_snapshot.json")
+        # 3. 写入磁盘
+        try:
+            with open(filepath, "w", encoding='utf-8') as f:
+                json.dump(world_state, f, indent=2, ensure_ascii=False, default=self.json_serializer)
+        except TypeError as e:
+            self.logger.error(f"JSON序列化错误: {str(e)}")
+            # 打印world_state的结构，帮助定位问题
+            self.logger.debug("World state structure:")
+            self.logger.debug(world_state)
+            raise
+            
+        self.echo(f">>> 世界已保存至 {filepath}")
+        # 9. 清理资源
+        self.running = False
+
+    def load_matrix(self):
+        
+        """一键复活"""
+        self.echo(f">>> 正在从 {self.matrix_path} 恢复世界...")
+        
+        matrix_snapshot_path = os.path.join(self.matrix_path,".matrix" , "matrix_snapshot.json")
+        os.makedirs(os.path.dirname(matrix_snapshot_path), exist_ok=True)
+        #加载向量数据库
+        
+        try:
+            with open(matrix_snapshot_path, "r", encoding='utf-8') as f:
+                content = f.read().strip()
+                if not content:  # 文件为空
+                    self.echo(f">>> {matrix_snapshot_path} 为空，创建新的世界状态...")
+                    world_state = {}
+                    with open(matrix_snapshot_path, "w", encoding='utf-8') as f:
+                        json.dump(world_state, f, ensure_ascii=False, indent=2)
+                else:
+                    world_state = json.loads(content)  # 使用 json.loads 而不是 json.load
+        except FileNotFoundError:
+            self.echo(f">>> 未找到 {matrix_snapshot_path}，创建新的世界状态...")
+            world_state = {}
+            with open(matrix_snapshot_path, "w", encoding='utf-8') as f:
+                json.dump(world_state, f, ensure_ascii=False, indent=2)
+
+        # 1. 恢复 Agent 状态
+        if world_state and "agents" in world_state:
+
+            for agent in self.agents.values():
+                if agent.name in world_state["agents"]:
+                    agent_data = world_state["agents"][agent.name]
+                    agent.load_state(agent_data)
+                    self.echo(f">>> 恢复 Agent {agent.name} 状态成功！" )
+        
+
+        
+
+        self.running_agent_tasks =[]
+        # 3. 注册到邮局
+        for agent in self.agents.values():
+            agent.workspace_root = self.matrix_path #设置root path
+            self.post_office.register(agent)
+            if hasattr(agent, 'vector_db'):
+                agent.vector_db = self.vector_db
+
+            self.running_agent_tasks.append(asyncio.create_task(agent.run()))
+            self.echo(f">>> Agent {agent.name} 已注册到邮局！")
+            self.logger.info(f"Agent {agent.name} prompt:")
+            self.logger.info(f"{agent.get_prompt()}")
+        
+    
+        # 4. 恢复投递
+        self.post_office.resume()
+        if world_state and 'post_office' in world_state:
+            for email_dict in world_state["post_office"]:
+                self.post_office.queue.put_nowait(Email(**email_dict))
+        
+        
+        self.running = True
+        self.echo(">>> 世界已恢复，系统继续运行！")
+        yellow_page = self.post_office.yellow_page()
+        self.echo(f">>> 当前世界中的 Agent 有：\n{yellow_page}")

agentmatrix/core/session.py

@@ -0,0 +1,20 @@
+from dataclasses import dataclass, field
+from typing import List, Dict
+from dataclasses import asdict
+
+@dataclass
+class TaskSession:
+    session_id: str          # 等于触发该任务的原始邮件 ID
+    original_sender: str     # 谁派的活
+    history: List[Dict]      # 对话历史
+    status: str = "RUNNING"  # RUNNING, WAITING
+    user_session_id: str = None  # 关联的用户会话 ID
+
+
+    def to_dict(self):
+        return asdict(self)
+
+    @classmethod
+    def from_dict(cls, data):
+        # 可以在这里做一些类型转换，比如把字符串转回 datetime
+        return cls(**data)

agentmatrix/db/__init__.py

@@ -0,0 +1 @@
+"""Database module for Agent-Matrix framework."""

agentmatrix/db/database.py

@@ -0,0 +1,79 @@
+import sqlite3
+import json
+from datetime import datetime
+from ..core.log_util import AutoLoggerMixin
+
+class AgentMailDB(AutoLoggerMixin):
+    def __init__(self, db_path):
+        self.conn = sqlite3.connect(db_path, check_same_thread=False)
+        self.create_tables()
+
+    def create_tables(self):
+        cursor = self.conn.cursor()
+        # 1. 邮件归档表 (The Global Mailbox)
+        cursor.execute('''
+            CREATE TABLE IF NOT EXISTS emails (
+                id TEXT PRIMARY KEY,
+                timestamp TEXT,
+                sender TEXT,
+                recipient TEXT,
+                subject TEXT,
+                body TEXT,
+                in_reply_to TEXT,
+                user_session_id TEXT,
+                metadata TEXT -- 存 JSON 格式的附件或其他信息
+            )
+        ''')
+        self.conn.commit()
+
+    def log_email(self, email):
+        """记录每一封信"""
+        cursor = self.conn.cursor()
+        cursor.execute('''
+            INSERT OR IGNORE INTO emails 
+            (id, timestamp, sender, recipient, subject, body, in_reply_to,user_session_id)
+            VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+        ''', (
+            email.id,
+            email.timestamp.isoformat(),
+            email.sender,
+            email.recipient,
+            email.subject,
+            email.body,
+            email.in_reply_to,
+            email.user_session_id
+        ))
+        self.conn.commit()
+
+    def get_mailbox(self, agent_name, limit=50):
+        """查询某个 Agent 的收件箱历史"""
+        cursor = self.conn.cursor()
+        cursor.execute('''
+            SELECT * FROM emails 
+            WHERE recipient = ? OR sender = ?
+            ORDER BY timestamp DESC LIMIT ?
+        ''', (agent_name, agent_name, limit))
+        columns = [col[0] for col in cursor.description]
+        return [dict(zip(columns, row)) for row in cursor.fetchall()]
+
+    def get_mails_by_range(self, agent_name, user_session_id, start=0, end=1):
+        """查询某个Agent的指定日期范围的邮件
+        Args:
+            agent_name: Agent名称
+            start: 起始索引（0表示最新邮件）
+            end: 结束索引
+        Returns:
+            指定范围内的邮件列表
+        """
+        cursor = self.conn.cursor()
+        cursor.execute('''
+            SELECT * FROM emails 
+            WHERE user_session_id = ? and (recipient = ? OR sender = ?)
+            ORDER BY timestamp DESC 
+            LIMIT ? OFFSET ?
+        ''', (user_session_id, agent_name, agent_name, end - start + 1, start))
+        columns = [col[0] for col in cursor.description]
+        return [dict(zip(columns, row)) for row in cursor.fetchall()]
+        
+
+