Diff match path

.github/workflows/hf_space_push.yml

@@ -0,0 +1,32 @@
+name: Sync Agent Tide Demo to Hugging Face Space
+on:
+  push:
+    branches: [main]    
+    tags: [ "*" ]
+  release:
+    types: [published, created, edited]
+
+  workflow_dispatch:
+
+jobs:
+  sync-to-hub:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+          lfs: true
+
+      - name: Deploy examples/hf_demo_space to HF Space
+        env:
+          HF_TOKEN: ${{ secrets.HF_TOKEN }}
+        run: |
+          cd examples/hf_demo_space
+          git init --initial-branch=main
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git remote add origin https://McLoviniTtt:$HF_TOKEN@huggingface.co/spaces/McLoviniTtt/AgentTideDemo
+          git add .
+          git commit -m "Deploy Agent Tide Demo to HF Space"
+          git push --force origin main

.github/workflows/python_package.yml

@@ -44,12 +44,12 @@ jobs:
           flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
           flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
       - name: Test with pytest
-        run: pytest tests --ignore=tests/agents
+        run: pytest tests --ignore=tests/agents --ignore=tests/mcp/tools
       - name: Install package with agents requirements
         run: |
-          python -m pip install .[agents]
+          python -m pip install -r requirements-agents.txt
       - name: Test agents with pytest
-        run: pytest tests/agents
+        run: pytest tests/agents tests/mcp/tools
   security:
     name: Security Check
     runs-on: ubuntu-latest

.gitignore

@@ -177,4 +177,7 @@ storage/
 logs/
 observability_data/
 config/
+*.db
+.files/
 
+codetide/agents/tide/ui/assets/

MANIFEST.in

@@ -0,0 +1,10 @@
+include requirements.txt
+include requirements-agents.txt
+include docs/assets/codetide-logo.png
+include requirements-visualization.txt
+include README.md
+
+# Include all files in codetide/agents/tide/ui/.chainlit and public directories (and subdirectories)
+recursive-include codetide/agents/tide/ui/.chainlit *
+recursive-include codetide/agents/tide/ui/public *
+recursive-include codetide/agents/tide/ui *

README.md

@@ -1,16 +1,23 @@
+<div align="center">
+
 <!-- [![Docs](https://img.shields.io/badge/docs-CodeTide.github.io-red)](https://brunov21.github.io/CodeTide/) -->
-# <img src="./docs/assets/codetide-logo.png" alt="code-tide-logo" width="35" height="auto"/> CodeTide
+<img src="./codetide/agents/tide/ui/public/codetide-banner.png" alt="code-tide-logo" width="900" height="auto"/>
+
+
+
 [![GitHub Stars](https://img.shields.io/github/stars/BrunoV21/CodeTide?style=social)](https://github.com/BrunoV21/CodeTide/stargazers)
 [![PyPI Downloads](https://static.pepy.tech/badge/CodeTide)](https://pepy.tech/projects/CodeTide)
 [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/CodeTide?style=flat)](https://pypi.org/pypi/codetide/)
 [![PyPI - Version](https://img.shields.io/pypi/v/CodeTide?style=flat)](https://pypi.org/pypi/codetide/)
 [![Pydantic v2](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/pydantic/pydantic/main/docs/badge/v2.json)](https://pydantic.dev)
---- 
 
-**CodeTide** is a fully local, privacy-preserving tool for parsing and understanding Python codebases using symbolic, structural analysis. No internet, no LLMs, no embeddings - just fast, explainable, and deterministic code intelligence.
+</div>
 
 ---
 
+**CodeTide** is a fully local, privacy-preserving tool for parsing and understanding Python codebases using symbolic, structural analysis. No internet, no LLMs, no embeddings - just fast, explainable, and deterministic code intelligence.
+
+
 ## ✅ Key Features
 
 - ✅ 100% **local & private** - all parsing and querying happens on your machine.
@@ -20,6 +27,64 @@
 - ⚡ Fast, cacheable parsing with smart update detection.
 - 🔁 Designed to work alongside tools like Copilot, GPT, and Claude - on your terms.
 
+
+---
+# Entrypoints & Usage
+
+CodeTide provides several entrypoints for interacting with the system via command-line and web UI. These entrypoints are exposed through the `uvx` launcher and require the appropriate extras to be installed.
+
+## CodeTide CLI
+
+To use the main CodeTide CLI:
+
+```sh
+uvx --from codetide codetide-cli --help
+```
+## AgentTide
+
+AgentTide consists of a demo, showing how CodeTide can integrate with LLMs and augment code generation and condebase related workflows. If you ask Tide to describe himself, he will say something like this: I'm the next-generation, precision-driven software engineering agent built on top of CodeTide. You can use it via the command-line interface (CLI) or a beautiful interactive UI.
+
+---
+
+<div align="center">
+<!-- [![Docs](https://img.shields.io/badge/docs-CodeTide.github.io-red)](https://brunov21.github.io/CodeTide/) -->
+<img src="./codetide/agents/tide/ui/public/agent-tide-demo.gif" alt="agent-tide-demo" width="100%" height="auto"/>
+</div>
+
+---
+
+**AgentTide CLI**
+
+To use the AgentTide conversational CLI, you must install the `[agents]` extra and launch via:
+
+```sh
+uvx --from codetide[agents] agent-tide
+```
+
+This will start an interactive terminal session with AgentTide.
+
+**AgentTide UI**
+
+To use the AgentTide web UI, you must install the `[agents-ui]` extra and launch via:
+
+```sh
+uvx --from codetide[agents-ui] agent-tide-ui
+```
+
+This will start a web server for the AgentTide UI. Follow the on-screen instructions to interact with the agent in your browser at [http://localhost:9753](http://localhost:9753) (or the port you specified)
+
+### Why Try AgentTide? ([Full Guide & Tips Here](codetide/agents/tide/ui/chainlit.md))
+
+**Local-First & Private:** All code analysis and patching is performed locally. Your code never leaves your machine.
+- **Transparent & Stepwise:** See every plan and patch before it's applied. Edit, reorder, or approve steps—you're always in control.
+- **Context-Aware:** AgentTide loads only the relevant code identifiers and dependencies for your request, making it fast and precise.
+- **Human-in-the-Loop:** After each step, review the patch, provide feedback, or continue—no black-box agent behavior.
+- **Patch-Based Editing:** All changes are atomic diffs, not full file rewrites, for maximum clarity and efficiency.
+
+**Usage Tips:**  
+If you know the exact code context, specify identifiers directly in your request (e.g., `module.submodule.file_withoutextension.object`).  
+You can request a plan, edit steps, and proceed step-by-step—see the [chainlit.md](codetide/agents/tide/ui/chainlit.md) for full details and advanced workflows!
+
 ---
 
 ## 🔌 VSCode Extension
@@ -461,6 +526,9 @@ Here’s what’s next for CodeTide:
 ~~- 🧭 **Handle relative imports** in Python projects  
   → Improve resolution for intra-package navigation.~~
 
+- 🚀 **AgentTideUi Hugging Face Space**  
+  → We are planning to make AgentTideUi available as a Hugging Face Space, supporting GitHub OAuth for user session and allowing users to provide a repo URL for one-time conversations.
+
 ---
 
 ## 🤖 Agents Module: AgentTide

codetide/__init__.py

@@ -1,7 +1,7 @@
 from codetide.core.defaults import (
     CODETIDE_ASCII_ART, DEFAULT_SERIALIZATION_PATH, DEFAULT_MAX_CONCURRENT_TASKS,
     DEFAULT_BATCH_SIZE, DEFAULT_CACHED_ELEMENTS_FILE, DEFAULT_CACHED_IDS_FILE,
-    LANGUAGE_EXTENSIONS
+    LANGUAGE_EXTENSIONS, SKIP_EXTENSIONS
 )
 from codetide.core.models import CodeFileModel, CodeBase, CodeContextStructure
 from codetide.core.common import readFile, writeFile
@@ -474,6 +474,18 @@ async def check_for_updates(self,
                 include_cached_ids=kwargs.get("include_cached_ids", False)
             )
 
+    @staticmethod
+    def _is_file_content_valid(filepath :Path)->bool:
+        # Lowercase name for case-insensitive matching
+        name_lower = filepath.name.lower()
+
+        # Skip if extension or full filename is in SKIP_EXTENSIONS
+        for ext in SKIP_EXTENSIONS:
+            if name_lower.endswith(ext.lower()):
+                return False
+
+        return True
+
     def _precheck_id_is_file(self, unique_ids : List[str])->Dict[Path, str]:
         """
         Preload file contents for the given IDs if they correspond to known files.
@@ -486,7 +498,7 @@ def _precheck_id_is_file(self, unique_ids : List[str])->Dict[Path, str]:
         """
         return {
             unique_id: readFile(self.rootpath / unique_id) for unique_id in unique_ids
-            if self.rootpath / unique_id in self.files
+            if self.rootpath / unique_id in self.files and self._is_file_content_valid(self.rootpath / unique_id)
         }
 
     def get(

codetide/agents/data_layer.py

@@ -0,0 +1,179 @@
+try:
+    from sqlalchemy.orm import declarative_base, relationship, mapped_column
+    from sqlalchemy import String, Text, ForeignKey, Boolean, Integer
+    from sqlalchemy.ext.asyncio import create_async_engine
+    from sqlalchemy.types import TypeDecorator
+except ImportError as e:
+    raise ImportError(
+        "This module requires 'sqlalchemy' and 'ulid-py'. "
+        "Install them with: pip install codetide[agents-ui]"
+    ) from e
+
+from datetime import datetime
+from sqlalchemy import Select
+from ulid import ulid
+import asyncio
+import json
+
+# SQLite-compatible JSON and UUID types
+class GUID(TypeDecorator):
+    impl = String
+
+    def process_bind_param(self, value, dialect):
+        if value is None:
+            return None
+        return str(value)
+
+    def process_result_value(self, value, dialect):
+        return value
+class JSONEncodedDict(TypeDecorator):
+    impl = Text
+
+    def process_bind_param(self, value, dialect):
+        return json.dumps(value) if value is not None else None
+
+    def process_result_value(self, value, dialect):
+        return json.loads(value) if value is not None else None
+
+class JSONEncodedList(TypeDecorator):
+    impl = Text
+
+    def process_bind_param(self, value, dialect):
+        return json.dumps(value) if value is not None else None
+
+    def process_result_value(self, value, dialect):
+        return json.loads(value) if value is not None else None
+
+Base = declarative_base()
+
+class User(Base):
+    __tablename__ = "users"
+    id = mapped_column(GUID, primary_key=True, default=ulid)
+    identifier = mapped_column(Text, unique=True, nullable=False)
+    user_metadata = mapped_column("metadata", JSONEncodedDict, nullable=False)
+    createdAt = mapped_column(Text, default=lambda: datetime.utcnow().isoformat())
+
+class Thread(Base):
+    __tablename__ = "threads"
+    id = mapped_column(GUID, primary_key=True, default=ulid)
+    createdAt = mapped_column(Text, default=lambda: datetime.utcnow().isoformat())
+    name = mapped_column(Text)
+    userId = mapped_column(GUID, ForeignKey("users.id", ondelete="CASCADE"))
+    userIdentifier = mapped_column(Text)
+    tags = mapped_column(JSONEncodedList)
+    user_metadata = mapped_column("metadata", JSONEncodedDict)
+
+    user = relationship("User", backref="threads")
+
+class Step(Base):
+    __tablename__ = "steps"
+    id = mapped_column(GUID, primary_key=True, default=ulid)
+    name = mapped_column(Text, nullable=False)
+    type = mapped_column(Text, nullable=False)
+    threadId = mapped_column(GUID, ForeignKey("threads.id", ondelete="CASCADE"), nullable=False)
+    parentId = mapped_column(GUID)
+    streaming = mapped_column(Boolean, nullable=False)
+    waitForAnswer = mapped_column(Boolean)
+    isError = mapped_column(Boolean)
+    user_metadata = mapped_column("metadata", JSONEncodedDict)
+    tags = mapped_column(JSONEncodedList)
+    input = mapped_column(Text)
+    output = mapped_column(Text)
+    createdAt = mapped_column(Text, default=lambda: datetime.utcnow().isoformat())
+    command = mapped_column(Text)
+    start = mapped_column(Text)
+    end = mapped_column(Text)
+    generation = mapped_column(JSONEncodedDict)
+    showInput = mapped_column(Text)
+    language = mapped_column(Text)
+    indent = mapped_column(Integer)
+    defaultOpen = mapped_column(Boolean, default=False)
+
+class Element(Base):
+    __tablename__ = "elements"
+    id = mapped_column(GUID, primary_key=True, default=ulid)
+    threadId = mapped_column(GUID, ForeignKey("threads.id", ondelete="CASCADE"))
+    type = mapped_column(Text)
+    url = mapped_column(Text)
+    chainlitKey = mapped_column(Text)
+    name = mapped_column(Text, nullable=False)
+    display = mapped_column(Text)
+    objectKey = mapped_column(Text)
+    size = mapped_column(Text)
+    page = mapped_column(Integer)
+    language = mapped_column(Text)
+    forId = mapped_column(GUID)
+    mime = mapped_column(Text)
+    props = mapped_column(JSONEncodedDict)
+
+class Feedback(Base):
+    __tablename__ = "feedbacks"
+    id = mapped_column(GUID, primary_key=True, default=ulid)
+    forId = mapped_column(GUID, nullable=False)
+    threadId = mapped_column(GUID, ForeignKey("threads.id", ondelete="CASCADE"), nullable=False)
+    value = mapped_column(Integer, nullable=False)
+    comment = mapped_column(Text)
+
+# class AsyncMessageDB:
+#     def __init__(self, db_path: str):
+#         self.db_url = f"sqlite+aiosqlite:///{db_path}"
+#         self.engine = create_async_engine(self.db_url, echo=False)
+#         self.async_session = async_sessionmaker(bind=self.engine, class_=AsyncSession, expire_on_commit=False)
+
+#     async def init_db(self):
+#         async with self.engine.begin() as conn:
+#             await conn.run_sync(Base.user_metadata.create_all)
+
+#     async def create_chat(self, name: str) -> Chat:
+#         async with self.async_session() as session:
+#             chat = Chat(name=name)
+#             session.add(chat)
+#             await session.commit()
+#             await session.refresh(chat)
+#             return chat
+
+#     async def add_message(self, chat_id: str, role: str, content: str) -> Message:
+#         async with self.async_session() as session:
+#             message = Message(chat_id=chat_id, role=role, content=content)
+#             session.add(message)
+#             await session.commit()
+#             await session.refresh(message)
+#             return message
+
+#     async def get_messages_for_chat(self, chat_id: str) -> List[Message]:
+#         async with self.async_session() as session:
+#             result = await session.execute(
+#                 select(Message).where(Message.chat_id == chat_id).order_by(Message.timestamp)
+#             )
+#             return result.scalars().all()
+
+#     async def list_chats(self) -> List[Chat]:
+#         async with self.async_session() as session:
+#             result = await session.execute(select(Chat).order_by(Chat.name))
+#             return result.scalars().all()
+
+# async def main():
+#     db = AsyncMessageDB(str(Path(os.path.abspath(__file__)).parent / "my_messages.db"))
+#     await db.init_db()
+
+#     chat = await db.create_chat("My First Chat")
+#     await db.add_message(chat.id, "user", "Hello Assistant!")
+#     await db.add_message(chat.id, "assistant", "Hello, how can I help you?")
+
+#     print(f"Messages for chat '{chat.name}':")
+#     messages = await db.get_messages_for_chat(chat.id)
+#     for msg in messages:
+#         print(f"[{msg.timestamp}] {msg.role.upper()}: {msg.content}")
+
+#     print("\nAll chats:")
+#     chats = await db.list_chats()
+#     for c in chats:
+#         print(f"{c.id} — {c.name}")
+async def init_db(path: str):
+    from sqlalchemy.ext.asyncio import async_sessionmaker, AsyncSession
+    engine = create_async_engine(f"sqlite+aiosqlite:///{path}")
+    async with engine.begin() as conn:
+        await conn.run_sync(Base.metadata.create_all)
+
+if __name__ == "__main__":
+    asyncio.run(init_db("database.db"))