iatoolkit 2.25.0__tar.gz → 2.25.1__tar.gz

{iatoolkit-2.25.0/src/iatoolkit.egg-info → iatoolkit-2.25.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iatoolkit
-Version: 2.25.0
+Version: 2.25.1
 Summary: IAToolkit
 Author: Fernando Libedinsky
 License-Expression: MIT

{iatoolkit-2.25.0 → iatoolkit-2.25.1}/src/iatoolkit/__init__.py

@@ -3,7 +3,7 @@
 #
 # IAToolkit is open source software.
 
-__version__ = "2.25.0"
+__version__ = "2.25.1"
 
 # Expose main classes and functions at the top level of the package
 

{iatoolkit-2.25.0 → iatoolkit-2.25.1}/src/iatoolkit/config/system_tools_pack.yaml

@@ -276,6 +276,86 @@ tools:
           description: "Opcional en la práctica. Usa null cuando no necesites filtrar por metadata. No inventes filtros ni envíes [] por defecto. Ejemplo: [{'key':'doc.type','value':'invoice'},{'key':'chunk.source_type','value':'table'}]."
       required:
         - query
+  - function_name: iat_knowledge_wiki_search
+    description: Busca páginas publicadas dentro de las wikis de conocimiento compartidas por la empresa. Úsala para políticas, playbooks, procesos, runbooks, conocimiento operativo, onboarding, guías por área o información curada del tenant. No es memoria personal del usuario ni búsqueda documental cruda.
+    routing:
+      force_include_capability: has_knowledge_wikis
+    routing_profile:
+      tags:
+        - knowledge_wiki
+        - company_knowledge
+        - tenant_context
+        - playbook
+        - policy
+        - process
+        - runbook
+        - onboarding
+        - wiki
+      intents:
+        - Search curated company wiki pages for policies, processes, playbooks, runbooks, or area knowledge.
+        - Retrieve published tenant knowledge before answering operational questions.
+        - Find the relevant company wiki page when the user asks about internal procedures.
+      examples:
+        - iat_knowledge_wiki_search(query="politica de descuentos enterprise", wiki_key="sales", limit=5)
+        - iat_knowledge_wiki_search(query="como escalar incidentes sev1", wiki_key="ops", limit=3)
+        - iat_knowledge_wiki_search(query="onboarding de nuevos ejecutivos", limit=5)
+      cost:
+        penalty: 0.07
+        latency_class: low
+        expensive: false
+    parameters:
+      type: object
+      properties:
+        query:
+          type: string
+          description: Texto que describe el conocimiento publicado que deseas recuperar.
+        wiki_key:
+          anyOf:
+            - type: string
+            - type: "null"
+          description: Clave opcional de la wiki a consultar. Usa null para buscar en todas las wikis publicadas.
+        limit:
+          type: integer
+          description: Cantidad máxima de páginas a recuperar.
+          minimum: 1
+          maximum: 25
+      required:
+        - query
+        - limit
+  - function_name: iat_knowledge_wiki_get_page
+    description: Recupera una página completa de una wiki de conocimiento compartida por la empresa usando wiki_key y path/slug. Úsala después de iat_knowledge_wiki_search cuando necesites leer el contenido completo antes de responder.
+    routing:
+      force_include_capability: has_knowledge_wikis
+    routing_profile:
+      tags:
+        - knowledge_wiki
+        - company_knowledge
+        - tenant_context
+        - page
+        - markdown
+        - wiki
+      intents:
+        - Open a published tenant wiki page by path or slug.
+        - Read the full markdown content of a company knowledge page before answering.
+      examples:
+        - iat_knowledge_wiki_get_page(wiki_key="sales", path="pricing.md")
+        - iat_knowledge_wiki_get_page(wiki_key="ops", path="incident-response.md")
+      cost:
+        penalty: 0.04
+        latency_class: low
+        expensive: false
+    parameters:
+      type: object
+      properties:
+        wiki_key:
+          type: string
+          description: Clave de la wiki publicada.
+        path:
+          type: string
+          description: Path o slug de la página a recuperar.
+      required:
+        - wiki_key
+        - path
   - function_name: iat_memory_search
     description: Busca páginas relevantes dentro de la Memoria personal del usuario y retorna contexto compilado. Incluye la señal `has_native_files` cuando una memoria tiene archivos fuente que pueden adjuntarse nativamente al modelo. Debe usarse antes de responder preguntas sobre cosas guardadas, notas previas, memoria del usuario, continuidad entre sesiones o "lo que hablamos/guardé antes".
     routing:

{iatoolkit-2.25.0 → iatoolkit-2.25.1}/src/iatoolkit/locales/en.yaml

@@ -621,6 +621,46 @@ ui:
     description: "Description"
     skills: "Skills"
 
+  knowledge_wikis:
+    menu_label: "Wikis"
+    title: "Knowledge wikis"
+    wikis: "Wikis"
+    new_wiki: "New wiki"
+    configure: "Configuration"
+    key: "Key"
+    name: "Name"
+    root: "Storage root"
+    status: "Status"
+    status_published: "Published"
+    status_draft: "Draft"
+    status_archived: "Archived"
+    description: "Description"
+    pages: "Pages"
+    index: "Index"
+    mcp: "MCP"
+    lint: "Review"
+    sync: "Sync"
+    issues: "issues"
+    index_resource: "Index resource"
+    copy_uri: "Copy URI"
+    publish_mcp: "Publish to MCP"
+    open_mcp: "Open MCP"
+    filter_pages: "Filter pages"
+    loading: "Loading..."
+    empty: "No wikis configured."
+    no_pages: "No pages."
+    no_issues: "No issues."
+    missing_key: "Wiki key is required."
+    save_ok: "Wiki saved."
+    save_error: "Could not save wiki."
+    sync_ok: "Sync queued."
+    sync_error: "Could not sync wiki."
+    lint_ok: "Review completed."
+    lint_error: "Could not review wiki."
+    mcp_ok: "Wiki published to MCP."
+    mcp_error: "Could not publish to MCP."
+    copy_ok: "URI copied."
+
   skills:
     title: "Skills"
     search_placeholder: "Search skills"

{iatoolkit-2.25.0 → iatoolkit-2.25.1}/src/iatoolkit/locales/es.yaml

@@ -621,6 +621,46 @@ ui:
     description: "Descripción"
     skills: "Skills"
 
+  knowledge_wikis:
+    menu_label: "Wikis"
+    title: "Wikis de conocimiento"
+    wikis: "Wikis"
+    new_wiki: "Nueva wiki"
+    configure: "Configuración"
+    key: "Clave"
+    name: "Nombre"
+    root: "Raíz storage"
+    status: "Estado"
+    status_published: "Publicada"
+    status_draft: "Borrador"
+    status_archived: "Archivada"
+    description: "Descripción"
+    pages: "Páginas"
+    index: "Índice"
+    mcp: "MCP"
+    lint: "Revisar"
+    sync: "Sincronizar"
+    issues: "hallazgos"
+    index_resource: "Resource de índice"
+    copy_uri: "Copiar URI"
+    publish_mcp: "Publicar en MCP"
+    open_mcp: "Abrir MCP"
+    filter_pages: "Filtrar páginas"
+    loading: "Cargando..."
+    empty: "No hay wikis configuradas."
+    no_pages: "No hay páginas."
+    no_issues: "Sin issues."
+    missing_key: "Debes ingresar una key de wiki."
+    save_ok: "Wiki guardada."
+    save_error: "No se pudo guardar la wiki."
+    sync_ok: "Sincronización encolada."
+    sync_error: "No se pudo sincronizar la wiki."
+    lint_ok: "Revisión completada."
+    lint_error: "No se pudo revisar la wiki."
+    mcp_ok: "Wiki publicada en MCP."
+    mcp_error: "No se pudo publicar en MCP."
+    copy_ok: "URI copiada."
+
   skills:
     title: "Skills"
     search_placeholder: "Buscar skills"

iatoolkit-2.25.1/src/iatoolkit/repositories/knowledge_wiki_repo.py

@@ -0,0 +1,218 @@
+# Copyright (c) 2024 Fernando Libedinsky
+# Product: IAToolkit
+#
+# IAToolkit is open source software.
+
+from __future__ import annotations
+
+from datetime import datetime
+
+from injector import inject
+
+from iatoolkit.repositories.database_manager import DatabaseManager
+from iatoolkit.repositories.models import (
+    KnowledgeWiki,
+    KnowledgeWikiPage,
+    KnowledgeWikiPageStatus,
+    KnowledgeWikiStatus,
+    KnowledgeWikiSyncRun,
+    KnowledgeWikiSyncStatus,
+)
+
+
+class KnowledgeWikiRepo:
+    @inject
+    def __init__(self, db_manager: DatabaseManager):
+        self.session = db_manager.get_session()
+
+    def commit(self):
+        self.session.commit()
+
+    def rollback(self):
+        self.session.rollback()
+
+    def get_wiki_by_key(self, company_id: int, wiki_key: str) -> KnowledgeWiki | None:
+        if not company_id or not wiki_key:
+            return None
+        return (
+            self.session.query(KnowledgeWiki)
+            .filter_by(company_id=company_id, wiki_key=wiki_key)
+            .first()
+        )
+
+    def get_wiki(self, company_id: int, wiki_id: int) -> KnowledgeWiki | None:
+        if not company_id or not wiki_id:
+            return None
+        return (
+            self.session.query(KnowledgeWiki)
+            .filter_by(company_id=company_id, id=wiki_id)
+            .first()
+        )
+
+    def list_wikis(self, company_id: int, *, include_archived: bool = False) -> list[KnowledgeWiki]:
+        if not company_id:
+            return []
+        query = self.session.query(KnowledgeWiki).filter_by(company_id=company_id)
+        if not include_archived:
+            query = query.filter(KnowledgeWiki.status != KnowledgeWikiStatus.ARCHIVED)
+        return query.order_by(KnowledgeWiki.name.asc(), KnowledgeWiki.id.asc()).all()
+
+    def create_or_update_wiki(
+        self,
+        *,
+        company_id: int,
+        wiki_key: str,
+        name: str,
+        root_storage_key: str,
+        description: str | None = None,
+        status: KnowledgeWikiStatus = KnowledgeWikiStatus.PUBLISHED,
+        settings: dict | None = None,
+    ) -> KnowledgeWiki:
+        wiki = self.get_wiki_by_key(company_id, wiki_key)
+        if wiki:
+            wiki.name = name
+            wiki.description = description
+            wiki.root_storage_key = root_storage_key
+            wiki.status = status
+            wiki.settings = settings or {}
+        else:
+            wiki = KnowledgeWiki(
+                company_id=company_id,
+                wiki_key=wiki_key,
+                name=name,
+                description=description,
+                root_storage_key=root_storage_key,
+                status=status,
+                settings=settings or {},
+            )
+            self.session.add(wiki)
+        self.session.commit()
+        return wiki
+
+    def get_page_by_path(self, wiki_id: int, path: str) -> KnowledgeWikiPage | None:
+        if not wiki_id or not path:
+            return None
+        return (
+            self.session.query(KnowledgeWikiPage)
+            .filter_by(wiki_id=wiki_id, path=path)
+            .first()
+        )
+
+    def get_page_by_slug(self, wiki_id: int, slug: str) -> KnowledgeWikiPage | None:
+        if not wiki_id or not slug:
+            return None
+        return (
+            self.session.query(KnowledgeWikiPage)
+            .filter_by(wiki_id=wiki_id, slug=slug)
+            .first()
+        )
+
+    def list_pages(
+        self,
+        wiki_id: int,
+        *,
+        include_archived: bool = False,
+        limit: int = 500,
+    ) -> list[KnowledgeWikiPage]:
+        if not wiki_id:
+            return []
+        query = self.session.query(KnowledgeWikiPage).filter_by(wiki_id=wiki_id)
+        if not include_archived:
+            query = query.filter(KnowledgeWikiPage.status != KnowledgeWikiPageStatus.ARCHIVED)
+        return (
+            query
+            .order_by(KnowledgeWikiPage.path.asc(), KnowledgeWikiPage.id.asc())
+            .limit(limit)
+            .all()
+        )
+
+    def create_or_update_page(
+        self,
+        *,
+        company_id: int,
+        wiki_id: int,
+        path: str,
+        slug: str,
+        title: str,
+        source_storage_key: str,
+        summary: str | None = None,
+        body_text: str | None = None,
+        status: KnowledgeWikiPageStatus = KnowledgeWikiPageStatus.PUBLISHED,
+        tags: list[str] | None = None,
+        owner: str | None = None,
+        source_meta: dict | None = None,
+        last_synced_at: datetime | None = None,
+    ) -> KnowledgeWikiPage:
+        page = self.get_page_by_path(wiki_id, path)
+        if page is None:
+            page = self.get_page_by_slug(wiki_id, slug)
+
+        if page:
+            page.path = path
+            page.slug = slug
+            page.title = title
+            page.summary = summary
+            page.body_text = body_text
+            page.source_storage_key = source_storage_key
+            page.status = status
+            page.tags = tags or []
+            page.owner = owner
+            page.source_meta = source_meta or {}
+            page.last_synced_at = last_synced_at
+        else:
+            page = KnowledgeWikiPage(
+                company_id=company_id,
+                wiki_id=wiki_id,
+                path=path,
+                slug=slug,
+                title=title,
+                summary=summary,
+                body_text=body_text,
+                source_storage_key=source_storage_key,
+                status=status,
+                tags=tags or [],
+                owner=owner,
+                source_meta=source_meta or {},
+                last_synced_at=last_synced_at,
+            )
+            self.session.add(page)
+        self.session.commit()
+        return page
+
+    def archive_pages_not_in_paths(self, wiki_id: int, paths: set[str]) -> int:
+        if not wiki_id:
+            return 0
+        query = self.session.query(KnowledgeWikiPage).filter_by(wiki_id=wiki_id)
+        if paths:
+            query = query.filter(~KnowledgeWikiPage.path.in_(paths))
+        rows = query.all()
+        changed = 0
+        for page in rows:
+            if page.status != KnowledgeWikiPageStatus.ARCHIVED:
+                page.status = KnowledgeWikiPageStatus.ARCHIVED
+                changed += 1
+        if changed:
+            self.session.commit()
+        return changed
+
+    def create_sync_run(
+        self,
+        *,
+        company_id: int,
+        wiki_id: int,
+        metadata_json: dict | None = None,
+    ) -> KnowledgeWikiSyncRun:
+        run = KnowledgeWikiSyncRun(
+            company_id=company_id,
+            wiki_id=wiki_id,
+            status=KnowledgeWikiSyncStatus.RUNNING,
+            metadata_json=metadata_json or {},
+        )
+        self.session.add(run)
+        self.session.commit()
+        return run
+
+    def save_sync_run(self, run: KnowledgeWikiSyncRun) -> KnowledgeWikiSyncRun:
+        self.session.add(run)
+        self.session.commit()
+        return run

{iatoolkit-2.25.0 → iatoolkit-2.25.1}/src/iatoolkit/repositories/models.py

@@ -69,6 +69,25 @@ class MemoryCaptureStatus(str, enum.Enum):
     FAILED = "failed"
 
 
+class KnowledgeWikiStatus(str, enum.Enum):
+    DRAFT = "draft"
+    PUBLISHED = "published"
+    ARCHIVED = "archived"
+
+
+class KnowledgeWikiPageStatus(str, enum.Enum):
+    DRAFT = "draft"
+    PUBLISHED = "published"
+    ARCHIVED = "archived"
+    BROKEN = "broken"
+
+
+class KnowledgeWikiSyncStatus(str, enum.Enum):
+    RUNNING = "running"
+    SUCCESS = "success"
+    FAILED = "failed"
+
+
 # Cross-database JSON type:
 # - PostgreSQL: JSONB (for jsonb operators/functions/indexing)
 # - SQLite/others (tests): JSON
@@ -180,6 +199,16 @@ class Company(Base):
         back_populates="company",
         cascade="all, delete-orphan",
     )
+    knowledge_wikis = relationship(
+        "KnowledgeWiki",
+        back_populates="company",
+        cascade="all, delete-orphan",
+    )
+    knowledge_wiki_pages = relationship(
+        "KnowledgeWikiPage",
+        back_populates="company",
+        cascade="all, delete-orphan",
+    )
 
 
     def to_dict(self):
@@ -519,6 +548,100 @@ class VSImage(Base):
         return {column.key: getattr(self, column.key) for column in class_mapper(self.__class__).columns}
 
 
+class KnowledgeWiki(Base):
+    """Represents a published markdown knowledge wiki scoped to a tenant."""
+    __tablename__ = "iat_knowledge_wikis"
+
+    id = Column(Integer, primary_key=True, autoincrement=True)
+    company_id = Column(Integer, ForeignKey(f"{ORM_SCHEMA}.iat_companies.id", ondelete="CASCADE"), nullable=False)
+    wiki_key = Column(String, nullable=False)
+    name = Column(String, nullable=False)
+    description = Column(Text, nullable=True)
+    root_storage_key = Column(String, nullable=False)
+    status = Column(Enum(KnowledgeWikiStatus), nullable=False, default=KnowledgeWikiStatus.PUBLISHED)
+    settings = Column(JSON_NATIVE, nullable=False, default=dict)
+    last_synced_at = Column(DateTime, nullable=True)
+    created_at = Column(DateTime, default=datetime.now, nullable=False)
+    updated_at = Column(DateTime, default=datetime.now, onupdate=datetime.now, nullable=False)
+
+    __table_args__ = (
+        UniqueConstraint("company_id", "wiki_key", name="uix_knowledge_wiki_company_key"),
+    )
+
+    company = relationship("Company", back_populates="knowledge_wikis")
+    pages = relationship(
+        "KnowledgeWikiPage",
+        back_populates="wiki",
+        cascade="all, delete-orphan",
+    )
+    sync_runs = relationship(
+        "KnowledgeWikiSyncRun",
+        back_populates="wiki",
+        cascade="all, delete-orphan",
+    )
+
+    def to_dict(self):
+        return {column.key: getattr(self, column.key) for column in class_mapper(self.__class__).columns}
+
+
+class KnowledgeWikiPage(Base):
+    """Represents one published markdown page inside a tenant knowledge wiki."""
+    __tablename__ = "iat_knowledge_wiki_pages"
+
+    id = Column(Integer, primary_key=True, autoincrement=True)
+    company_id = Column(Integer, ForeignKey(f"{ORM_SCHEMA}.iat_companies.id", ondelete="CASCADE"), nullable=False)
+    wiki_id = Column(Integer, ForeignKey(f"{ORM_SCHEMA}.iat_knowledge_wikis.id", ondelete="CASCADE"), nullable=False)
+    path = Column(String, nullable=False)
+    slug = Column(String, nullable=False)
+    title = Column(String, nullable=False)
+    summary = Column(Text, nullable=True)
+    body_text = Column(Text, nullable=True)
+    source_storage_key = Column(String, nullable=False)
+    status = Column(Enum(KnowledgeWikiPageStatus), nullable=False, default=KnowledgeWikiPageStatus.PUBLISHED)
+    tags = Column(JSON_NATIVE, nullable=False, default=list)
+    owner = Column(String, nullable=True)
+    source_meta = Column(JSON_NATIVE, nullable=False, default=dict)
+    last_synced_at = Column(DateTime, nullable=True)
+    created_at = Column(DateTime, default=datetime.now, nullable=False)
+    updated_at = Column(DateTime, default=datetime.now, onupdate=datetime.now, nullable=False)
+
+    __table_args__ = (
+        UniqueConstraint("wiki_id", "path", name="uix_knowledge_wiki_page_path"),
+        UniqueConstraint("wiki_id", "slug", name="uix_knowledge_wiki_page_slug"),
+    )
+
+    company = relationship("Company", back_populates="knowledge_wiki_pages")
+    wiki = relationship("KnowledgeWiki", back_populates="pages")
+
+    def to_dict(self):
+        return {column.key: getattr(self, column.key) for column in class_mapper(self.__class__).columns}
+
+
+class KnowledgeWikiSyncRun(Base):
+    """Tracks one import/reindex pass for a tenant knowledge wiki."""
+    __tablename__ = "iat_knowledge_wiki_sync_runs"
+
+    id = Column(Integer, primary_key=True, autoincrement=True)
+    company_id = Column(Integer, ForeignKey(f"{ORM_SCHEMA}.iat_companies.id", ondelete="CASCADE"), nullable=False)
+    wiki_id = Column(Integer, ForeignKey(f"{ORM_SCHEMA}.iat_knowledge_wikis.id", ondelete="CASCADE"), nullable=False)
+    status = Column(Enum(KnowledgeWikiSyncStatus), nullable=False, default=KnowledgeWikiSyncStatus.RUNNING)
+    pages_seen = Column(Integer, nullable=False, default=0)
+    pages_indexed = Column(Integer, nullable=False, default=0)
+    pages_failed = Column(Integer, nullable=False, default=0)
+    errors = Column(JSON_NATIVE, nullable=False, default=list)
+    metadata_json = Column(JSON_NATIVE, nullable=False, default=dict)
+    started_at = Column(DateTime, default=datetime.now, nullable=False)
+    finished_at = Column(DateTime, nullable=True)
+    created_at = Column(DateTime, default=datetime.now, nullable=False)
+    updated_at = Column(DateTime, default=datetime.now, onupdate=datetime.now, nullable=False)
+
+    company = relationship("Company")
+    wiki = relationship("KnowledgeWiki", back_populates="sync_runs")
+
+    def to_dict(self):
+        return {column.key: getattr(self, column.key) for column in class_mapper(self.__class__).columns}
+
+
 class UserFeedback(Base):
     """Stores feedback and ratings submitted by users for specific interactions."""
     __tablename__ = 'iat_feedback'