iatoolkit 2.62.1__tar.gz → 2.63.0__tar.gz

{iatoolkit-2.62.1/src/iatoolkit.egg-info → iatoolkit-2.63.0}/PKG-INFO

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

{iatoolkit-2.62.1 → iatoolkit-2.63.0}/src/iatoolkit/__init__.py

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

{iatoolkit-2.62.1 → iatoolkit-2.63.0}/src/iatoolkit/common/routes.py

@@ -52,6 +52,7 @@ def register_views(app):
     from iatoolkit.views.tool_api_view import ToolApiView
     from iatoolkit.views.api_key_api_view import ApiKeyApiView
     from iatoolkit.views.memory_api_view import MemoryApiView
+    from iatoolkit.views.wiki_page_view import WikiPageView
 
     # Dependency-free liveness endpoint for load balancer/orchestrator health
     # checks (ALB, ECS, Docker HEALTHCHECK, etc). Deliberately returns a plain
@@ -103,6 +104,14 @@ def register_views(app):
                      view_func=AccountView.as_view('account'),
                      methods=['GET', 'POST'])
 
+    # a knowledge wiki page in the browser: where the wiki tools' `url` points
+    wiki_page_view = WikiPageView.as_view('wiki_page')
+    app.add_url_rule('/<company_short_name>/wiki/<wiki_key>/',
+                     defaults={'page_path': ''},
+                     view_func=wiki_page_view)
+    app.add_url_rule('/<company_short_name>/wiki/<wiki_key>/<path:page_path>',
+                     view_func=wiki_page_view)
+
     # this endpoint is called when onboarding_shell finish the context load
     app.add_url_rule(
         '/<company_short_name>/finalize',

{iatoolkit-2.62.1 → iatoolkit-2.63.0}/src/iatoolkit/config/system_tools_pack.yaml

@@ -378,7 +378,7 @@ tools:
       required:
         - document_id
   - function_name: iat_wiki_search
-    description: Busca páginas publicadas dentro de las wikis de conocimiento compartidas por la empresa. Úsala como acelerador cuando necesites encontrar rápidamente una página relevante, pero no como punto de entrada por defecto. Si no conoces un `path` válido, primero llama `iat_wiki_get_page` con `path="/"` para leer el índice raíz de la wiki y seguir sus links exactos. `wiki_key` es el identificador estable de una wiki publicada, por ejemplo `sales`, `ops` o `hr`; úsalo cuando ya sepas en qué wiki buscar y omítelo cuando quieras buscar en todas las wikis publicadas disponibles en esta conexión MCP. Esta tool devuelve candidatos; luego usa `iat_wiki_get_page` para leer la página completa antes de responder.
+    description: Busca páginas publicadas dentro de las wikis de conocimiento compartidas por la empresa. Úsala como acelerador cuando necesites encontrar rápidamente una página relevante, pero no como punto de entrada por defecto. Si no conoces un `path` válido, primero llama `iat_wiki_get_page` con `path="/"` para leer el índice raíz de la wiki y seguir sus links exactos. `wiki_key` es el identificador estable de una wiki publicada, por ejemplo `sales`, `ops` o `hr`; úsalo cuando ya sepas en qué wiki buscar y omítelo cuando quieras buscar en todas las wikis publicadas disponibles en esta conexión MCP. Esta tool devuelve candidatos; luego usa `iat_wiki_get_page` para leer la página completa antes de responder. Cada candidato trae `url`, el link para abrir la página en el navegador.
     routing:
       force_include_capability: has_knowledge_wikis
     routing_profile:
@@ -427,7 +427,7 @@ tools:
     description: |-
       Wiki entrypoint: llama `iat_wiki_get_page` con `path="/"` para cargar el índice raíz de una wiki de conocimiento publicada del tenant.
       Lee **una** página de wiki y devuelve su contenido en Markdown. La wiki documenta contexto de negocio, áreas, sistemas internos, arquitectura, procesos, políticas, runbooks, onboarding, operaciones y glosarios. Es una wiki navegable por links: la página raíz `path="/"` es el punto de entrada y lista las páginas disponibles con sus paths exactos; después abre solo las páginas relevantes siguiendo esos links o los paths devueltos por iat_wiki_search (solo si esta habilitada).
-      `wiki_key` identifica la wiki publicada. Los `path` son sensibles a mayúsculas y deben coincidir EXACTAMENTE con el link o path publicado; no los inventes ni los reconstruyas de memoria. Si no conoces un path válido, vuelve a llamar con `path="/"`. Esta tool es de solo lectura y es segura de usar siempre que la documentación interna de la empresa ayude a responder. Prefiere abrir pocas páginas puntuales antes de recorrer el corpus completo. Cuando respondas usando material de la wiki, cita la página usada.
+      `wiki_key` identifica la wiki publicada. Los `path` son sensibles a mayúsculas y deben coincidir EXACTAMENTE con el link o path publicado; no los inventes ni los reconstruyas de memoria. Si no conoces un path válido, vuelve a llamar con `path="/"`. Esta tool es de solo lectura y es segura de usar siempre que la documentación interna de la empresa ayude a responder. Prefiere abrir pocas páginas puntuales antes de recorrer el corpus completo. Cuando respondas usando material de la wiki, cita la página usada; si trae `url`, cítala como link con esa URL exacta.
     routing:
       force_include_capability: has_knowledge_wikis
     routing_profile:

{iatoolkit-2.62.1 → iatoolkit-2.63.0}/src/iatoolkit/locales/en.yaml

@@ -377,6 +377,14 @@ ui:
     last_used: "Last used"
     never_used: "No recorded use"
 
+  wiki_page:
+    back_to_chat: "Back to chat"
+    trail_label: "Location in the wiki"
+    empty: "This page has no content."
+    not_found: "This page does not exist in the wiki or is no longer published."
+    forbidden: "You do not have access to this page."
+    forbidden_labels: "You do not have access to this page. You need one of these labels: {labels}."
+    unavailable: "We could not verify your access right now. Try again in a few minutes."
   memory:
     title: "Company memory"
     capture_title: "Teach the company something"

{iatoolkit-2.62.1 → iatoolkit-2.63.0}/src/iatoolkit/locales/es.yaml

@@ -391,6 +391,14 @@ ui:
     last_used: "Último uso"
     never_used: "Sin uso registrado"
 
+  wiki_page:
+    back_to_chat: "Volver al chat"
+    trail_label: "Ubicación en la wiki"
+    empty: "Esta página no tiene contenido."
+    not_found: "Esta página no existe en la wiki o ya no está publicada."
+    forbidden: "No tienes acceso a esta página."
+    forbidden_labels: "No tienes acceso a esta página. Necesitas alguna de estas etiquetas: {labels}."
+    unavailable: "No pudimos verificar tu acceso en este momento. Intenta de nuevo en unos minutos."
   memory:
     title: "Memoria de la empresa"
     capture_title: "Enseñar algo a la empresa"

{iatoolkit-2.62.1 → iatoolkit-2.63.0}/src/iatoolkit/services/tenant_wiki_service.py

@@ -14,7 +14,9 @@ import unicodedata
 from datetime import datetime
 from pathlib import PurePosixPath
 from typing import Any, Callable
+from urllib.parse import quote
 
+from flask import has_request_context, request
 from injector import inject
 
 from iatoolkit.repositories.knowledge_wiki_repo import KnowledgeWikiRepo
@@ -583,6 +585,37 @@ class TenantWikiService:
             "unlabelled": len(pages) - labelled,
         }
 
+    @classmethod
+    def page_url(cls, company_short_name: str, wiki_key: str, path: str | None) -> str | None:
+        """
+        Where a person opens a page in the browser: the page viewer, at the
+        page's own path, so the relative links between pages resolve without
+        rewriting them. The root page is the wiki's own folder.
+
+        `APP_BASE_URL` names the public host, because a scheduled job has no
+        request to take it from; without it the request's host is used, and
+        with neither there is no URL to give.
+        """
+        base = str(os.getenv("APP_BASE_URL") or "").strip().rstrip("/")
+        if not base and has_request_context():
+            base = request.url_root.rstrip("/")
+        if not base:
+            return None
+        return "/".join((
+            base,
+            quote(str(company_short_name or "").strip(), safe=""),
+            "wiki",
+            quote(cls.normalize_wiki_key(wiki_key), safe=""),
+            quote(cls._normalize_page_path(path), safe="/"),
+        ))
+
+    def _reader_url(self, company_short_name: str, wiki: KnowledgeWiki, path: str | None) -> str | None:
+        # A system wiki is read through the feature that owns it; the viewer
+        # answers "wiki not found" for it, so it gets no link.
+        if self.is_system_wiki(wiki):
+            return None
+        return self.page_url(company_short_name, wiki.wiki_key, path)
+
     def get_page(
         self,
         company_short_name: str,
@@ -638,12 +671,15 @@ class TenantWikiService:
             return {
                 "status": "success",
                 "wiki": self.serialize_wiki(wiki),
-                "page": self._build_virtual_index_page(
-                    wiki,
-                    markdown=markdown,
-                    source_storage_key=source_storage_key,
-                    path="/",
-                ),
+                "page": {
+                    **self._build_virtual_index_page(
+                        wiki,
+                        markdown=markdown,
+                        source_storage_key=source_storage_key,
+                        path="/",
+                    ),
+                    "url": self._reader_url(company_short_name, wiki, "/"),
+                },
             }
         if normalized_path == self.INDEX_FILENAME:
             entries = self._filter_page_entries(self._page_entries(wiki), visibility_filter=visibility_filter)
@@ -656,12 +692,15 @@ class TenantWikiService:
             return {
                 "status": "success",
                 "wiki": self.serialize_wiki(wiki),
-                "page": self._build_virtual_index_page(
-                    wiki,
-                    markdown=authored_index_markdown,
-                    source_storage_key=authored_index_storage_key,
-                    path=self.INDEX_FILENAME,
-                ),
+                "page": {
+                    **self._build_virtual_index_page(
+                        wiki,
+                        markdown=authored_index_markdown,
+                        source_storage_key=authored_index_storage_key,
+                        path=self.INDEX_FILENAME,
+                    ),
+                    "url": self._reader_url(company_short_name, wiki, self.INDEX_FILENAME),
+                },
             }
         page = self.knowledge_wiki_repo.get_page_by_path(wiki.id, normalized_path)
         if page is None:
@@ -689,6 +728,7 @@ class TenantWikiService:
                 **self.serialize_page(page, include_body=True),
                 "frontmatter": parsed.get("frontmatter") or {},
                 "markdown": markdown,
+                "url": self._reader_url(company_short_name, wiki, page.path),
             },
         }
 
@@ -1068,6 +1108,7 @@ class TenantWikiService:
                     **self.serialize_page(page, include_body=False),
                     "wiki_key": wiki.wiki_key,
                     "wiki_name": wiki.name,
+                    "url": self._reader_url(company_short_name, wiki, page.path),
                     "score": round(score if score > 0 else 1.0, 4),
                 })
 

iatoolkit-2.63.0/src/iatoolkit/static/styles/wiki_page.css

@@ -0,0 +1,35 @@
+.wiki-page {
+    --wiki-line: #e2e5e8;
+    --wiki-muted: #60666d;
+    max-width: 920px;
+    margin: 0 auto;
+    padding: 0 24px 64px;
+    color: #25292d;
+    font: 16px/1.6 system-ui, sans-serif;
+}
+.wiki-page * { box-sizing: border-box; min-width: 0; }
+.wiki-page-header { display: flex; align-items: center; justify-content: space-between; gap: 16px; padding: 20px 0 16px; border-bottom: 1px solid var(--wiki-line); }
+.wiki-page-brand { font-size: 18px; font-weight: 650; color: var(--brand-primary-color, #285e50); text-decoration: none; }
+.wiki-page-back { display: inline-flex; align-items: center; gap: 8px; font-size: 14px; color: var(--wiki-muted); text-decoration: none; }
+.wiki-page-back:hover { color: #25292d; }
+.wiki-page-trail { display: flex; flex-wrap: wrap; align-items: baseline; gap: 4px 12px; padding: 16px 0 8px; font-size: 14px; }
+.wiki-page-trail a { display: inline-flex; align-items: center; gap: 6px; font-weight: 600; color: var(--brand-primary-color, #285e50); text-decoration: none; }
+.wiki-page-path { color: var(--wiki-muted); font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 13px; overflow-wrap: anywhere; }
+.wiki-page-main { padding-top: 16px; }
+.wiki-page-notice { padding: 12px 16px; border-left: 3px solid #c9ced3; background: #f6f7f8; overflow-wrap: anywhere; }
+.wiki-page-body { overflow-wrap: anywhere; }
+.wiki-page-body h1 { font-size: 28px; line-height: 1.25; font-weight: 650; margin: 8px 0 20px; }
+.wiki-page-body h2 { font-size: 21px; line-height: 1.3; font-weight: 650; margin: 32px 0 12px; padding-bottom: 6px; border-bottom: 1px solid var(--wiki-line); }
+.wiki-page-body h3 { font-size: 17px; font-weight: 650; margin: 24px 0 8px; }
+.wiki-page-body a { color: var(--brand-primary-color, #285e50); }
+.wiki-page-body code { font-size: 0.9em; background: #f3f4f6; padding: 1px 4px; border-radius: 4px; overflow-wrap: anywhere; }
+.wiki-page-body pre { background: #f6f8fa; padding: 12px 16px; border-radius: 6px; overflow-x: auto; }
+.wiki-page-body pre code { background: none; padding: 0; }
+.wiki-page-body blockquote { margin: 0 0 16px; padding: 4px 16px; border-left: 3px solid var(--wiki-line); color: var(--wiki-muted); }
+.wiki-page-body table { display: block; max-width: 100%; overflow-x: auto; border-collapse: collapse; margin-bottom: 16px; font-size: 14px; }
+.wiki-page-body th, .wiki-page-body td { border: 1px solid var(--wiki-line); padding: 6px 10px; vertical-align: top; }
+.wiki-page-body thead { background: #f6f8fa; }
+@media (max-width: 600px) {
+    .wiki-page { padding: 0 16px 48px; }
+    .wiki-page-back span { display: none; }
+}

iatoolkit-2.63.0/src/iatoolkit/templates/wiki_page.html

@@ -0,0 +1,29 @@
+{% extends "base.html" %}
+{% set suppress_toasts = true %}
+{% block title %}{{ page_title }} · {{ wiki_name }}{% endblock %}
+{% block styles %}
+<style>{{ branding.css_variables | safe }}</style>
+<link rel="stylesheet" href="{{ url_for('static', filename='styles/wiki_page.css') }}">
+{% endblock %}
+{% block content %}
+<div class="wiki-page">
+    <header class="wiki-page-header">
+        <a class="wiki-page-brand" href="{{ url_for('chat', company_short_name=company_short_name) }}">{{ branding.name }}</a>
+        <a class="wiki-page-back" href="{{ url_for('chat', company_short_name=company_short_name) }}">
+            <i class="bi bi-chat-dots" aria-hidden="true"></i><span>{{ t('ui.wiki_page.back_to_chat') }}</span>
+        </a>
+    </header>
+    <nav class="wiki-page-trail" aria-label="{{ t('ui.wiki_page.trail_label') }}">
+        <a href="{{ root_url }}"><i class="bi bi-journal-text" aria-hidden="true"></i>{{ wiki_name }}</a>
+        {% if page_path %}<span class="wiki-page-path">{{ page_path }}</span>{% endif %}
+    </nav>
+    <main class="wiki-page-main">
+        {% if message %}
+        <div class="wiki-page-notice" role="status">{{ message }}</div>
+        {% endif %}
+        {% if body_html %}
+        <article class="wiki-page-body">{{ body_html | safe }}</article>
+        {% endif %}
+    </main>
+</div>
+{% endblock %}

iatoolkit-2.63.0/src/iatoolkit/views/wiki_page_view.py

@@ -0,0 +1,110 @@
+# Copyright (c) 2024 Fernando Libedinsky
+# Product: IAToolkit
+#
+# IAToolkit is open source software.
+
+import markdown2
+import nh3
+from flask import redirect, render_template, request, url_for
+from flask.views import MethodView
+from injector import inject
+
+from iatoolkit.services.branding_service import BrandingService
+from iatoolkit.services.i18n_service import I18nService
+from iatoolkit.services.markdown_wiki_service import MarkdownWikiService
+from iatoolkit.services.profile_service import ProfileService
+from iatoolkit.services.tenant_wiki_service import TenantWikiService
+
+
+class WikiPageView(MethodView):
+    """
+    A knowledge wiki page, read in the browser.
+
+    The link the wiki tools hand out (`TenantWikiService.page_url`) lands here.
+    The page is read as the signed-in person, so its visibility labels apply
+    exactly as they do in chat; without a session the person signs in and comes
+    back. The URL mirrors the page's path in the wiki, so the relative links
+    between pages resolve by themselves.
+    """
+
+    # `code-friendly`: in a technical wiki an underscore joins a name
+    # (SYS_alertas_push), it does not start italics.
+    MARKDOWN_EXTRAS = ["tables", "fenced-code-blocks", "strike", "task_list", "code-friendly"]
+
+    @inject
+    def __init__(self,
+                 profile_service: ProfileService,
+                 branding_service: BrandingService,
+                 i18n_service: I18nService,
+                 tenant_wiki_service: TenantWikiService):
+        self.profile_service = profile_service
+        self.branding_service = branding_service
+        self.i18n_service = i18n_service
+        self.tenant_wiki_service = tenant_wiki_service
+
+    def get(self, company_short_name: str, wiki_key: str, page_path: str = ""):
+        company = self.profile_service.get_company_by_short_name(company_short_name)
+        if not company:
+            return render_template('error.html',
+                                   message=self.i18n_service.t('errors.templates.company_not_found')), 404
+
+        session_info = self.profile_service.get_current_session_info(company_short_name=company_short_name) or {}
+        user_identifier = session_info.get('user_identifier')
+        if not user_identifier or session_info.get('company_short_name') != company_short_name:
+            # The home page carries `next` into its login widget.
+            return redirect(url_for('home', company_short_name=company_short_name,
+                                    next=request.full_path.rstrip('?')))
+
+        result = self.tenant_wiki_service.get_page(
+            company_short_name,
+            wiki_key=wiki_key,
+            path=page_path or "/",
+            user_identifier=user_identifier,
+        )
+        wiki = result.get("wiki") or {}
+        context = {
+            "company_short_name": company_short_name,
+            "branding": self.branding_service.get_company_branding(company_short_name),
+            "wiki_name": wiki.get("name") or wiki_key,
+            "root_url": url_for('wiki_page', company_short_name=company_short_name,
+                                wiki_key=wiki_key, page_path=''),
+            "page_path": page_path,
+        }
+
+        if result.get("status") == "success":
+            page = result.get("page") or {}
+            body = MarkdownWikiService.parse_frontmatter_document(page.get("markdown") or "").get("body")
+            return render_template(
+                "wiki_page.html",
+                **context,
+                page_title=page.get("title") or page_path or context["wiki_name"],
+                body_html=self.render_markdown(body),
+                message=None if body else self.i18n_service.t('ui.wiki_page.empty'),
+            )
+
+        status_code, message = self._denial(result)
+        return render_template(
+            "wiki_page.html",
+            **context,
+            page_title=page_path or context["wiki_name"],
+            body_html="",
+            message=message,
+        ), status_code
+
+    @classmethod
+    def render_markdown(cls, markdown: str | None) -> str:
+        if not str(markdown or "").strip():
+            return ""
+        return nh3.clean(markdown2.markdown(markdown, extras=cls.MARKDOWN_EXTRAS))
+
+    def _denial(self, result: dict) -> tuple[int, str]:
+        """A withheld page says why, as the wiki tools do; anything else is a 404."""
+        status = result.get("status")
+        if status == TenantWikiService.ACCESS_STATUS_UNAVAILABLE:
+            return 503, self.i18n_service.t('ui.wiki_page.unavailable')
+        if status == TenantWikiService.ACCESS_STATUS_FORBIDDEN:
+            labels = ", ".join(result.get("required_labels") or [])
+            if labels:
+                return 403, self.i18n_service.t('ui.wiki_page.forbidden_labels', labels=labels)
+            return 403, self.i18n_service.t('ui.wiki_page.forbidden')
+        return 404, self.i18n_service.t('ui.wiki_page.not_found')

{iatoolkit-2.62.1 → iatoolkit-2.63.0/src/iatoolkit.egg-info}/PKG-INFO

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

{iatoolkit-2.62.1 → iatoolkit-2.63.0}/src/iatoolkit.egg-info/SOURCES.txt

@@ -202,6 +202,7 @@ src/iatoolkit/static/styles/documents.css
 src/iatoolkit/static/styles/landing_page.css
 src/iatoolkit/static/styles/llm_output.css
 src/iatoolkit/static/styles/onboarding.css
+src/iatoolkit/static/styles/wiki_page.css
 src/iatoolkit/templates/_chat_header.html
 src/iatoolkit/templates/_company_header.html
 src/iatoolkit/templates/_login_widget.html
@@ -217,6 +218,7 @@ src/iatoolkit/templates/home_hosted_default.html
 src/iatoolkit/templates/login_global.html
 src/iatoolkit/templates/onboarding_shell.html
 src/iatoolkit/templates/signup.html
+src/iatoolkit/templates/wiki_page.html
 src/iatoolkit/templates/memory/wiki_schema.md
 src/iatoolkit/templates/pdf/base.html
 src/iatoolkit/templates/pdf/letter.html
@@ -254,4 +256,5 @@ src/iatoolkit/views/static_page_view.py
 src/iatoolkit/views/tool_api_view.py
 src/iatoolkit/views/user_feedback_api_view.py
 src/iatoolkit/views/users_api_view.py
-src/iatoolkit/views/verify_user_view.py
+src/iatoolkit/views/verify_user_view.py
+src/iatoolkit/views/wiki_page_view.py