iatoolkit 2.65.2__tar.gz → 2.67.0__tar.gz

{iatoolkit-2.65.2/src/iatoolkit.egg-info → iatoolkit-2.67.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iatoolkit
-Version: 2.65.2
+Version: 2.67.0
 Summary: IAToolkit
 Author: Fernando Libedinsky
 License-Expression: MIT
@@ -242,6 +242,7 @@ Perfect for developers, small teams, single-business use cases, and experimentat
 
 ## 📚 Documentation
 
+- 🐳 **[Docker installation](docker/README.md)** – Community Edition with PostgreSQL, Redis and populated Northwind data
 - 🚀 **[Quickstart](docs/quickstart.md)** – Set up your environment and run the project
 - ☁️ **[Deployment Guide](docs/deployment_guide.md)** – Production deployment instructions
 - 🏗️ **[Companies & Components](docs/companies_and_components.md)** – how Company modules work

{iatoolkit-2.65.2 → iatoolkit-2.67.0}/readme.md

@@ -151,6 +151,7 @@ Perfect for developers, small teams, single-business use cases, and experimentat
 
 ## 📚 Documentation
 
+- 🐳 **[Docker installation](docker/README.md)** – Community Edition with PostgreSQL, Redis and populated Northwind data
 - 🚀 **[Quickstart](docs/quickstart.md)** – Set up your environment and run the project
 - ☁️ **[Deployment Guide](docs/deployment_guide.md)** – Production deployment instructions
 - 🏗️ **[Companies & Components](docs/companies_and_components.md)** – how Company modules work

{iatoolkit-2.65.2 → iatoolkit-2.67.0}/src/iatoolkit/__init__.py

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

{iatoolkit-2.65.2 → iatoolkit-2.67.0}/src/iatoolkit/config/system_agents/memory_compiler.prompt

@@ -10,7 +10,7 @@ How to write the page:
 
 - Follow the WIKI_SCHEMA.
 - When you update, return the COMPLETE new page: keep everything already on it, word for word, including other people's attributions, headings and order. Change only what the capture changes, and put new facts in the section where they belong.
-- When the capture contradicts the page, keep both statements with their attributions and make the conflict explicit; never delete what someone else said.
+- When the capture contradicts the page, keep both statements with their attributions and make the conflict explicit; never delete what someone else said. Also list each contradiction in `conflicts`.
 - Attribute every fact you add as ({{ author }}, {{ captured_on }}).
 - Write in the language of the page, or of the capture for a new page. Neutral tone, no personal opinions.
 - If attachments come with the capture, use what they say as part of the capture.
@@ -23,6 +23,7 @@ Answer with JSON following the schema:
 - `summary`: one sentence saying what the page covers.
 - `markdown`: the page body without frontmatter, starting with `# Title`.
 - `change_summary`: one short sentence for the page history (when you skip, why).
+- `conflicts`: each place where the capture contradicts what the page already said, with `existing_statement` (what the page said, as written), `existing_source` (its attribution), `new_statement` and `new_source` ({{ author }}, {{ captured_on }}). An empty list when nothing contradicts.
 
 WIKI_SCHEMA:
 {{ wiki_schema }}

iatoolkit-2.67.0/src/iatoolkit/config/system_agents/memory_document_ingest.prompt

@@ -0,0 +1,35 @@
+You maintain the company's Memory: a wiki of how things are actually done in this company (procedures, rules, exceptions, who decides). It is written from what its people explain and from the company's own documents.
+
+A document was loaded into Memory (SOURCE). You receive it in parts; this is part {{ part.index }} of {{ part.total }} (PART). Bring into the wiki what this part teaches about how things are done here.
+
+What to take:
+
+- Facts, rules, procedures, responsibilities, exceptions, deadlines, amounts and definitions that someone in the company would need to know or do their work.
+- Not the document's structure, legal boilerplate, signatures, indexes or anything that only restates the title.
+- Do not summarize the document: the document itself stays searchable. Write the knowledge where it belongs.
+
+How to write the pages:
+
+- Update one of the CANDIDATE_PAGES when the part belongs to its subject; create a new page when none covers it (check PAGE_INDEX first so you do not duplicate a page). One part may touch several pages; return each one.
+- When you update, return the COMPLETE new page: keep everything already on it, word for word, including people's attributions. Add the new facts in the section where they belong.
+- When this part says something different from what the page already says, keep both statements with their attributions and make the difference explicit; never delete what someone else said. Also list each contradiction in `conflicts`.
+- Attribute every fact you add as ({{ source.label }}, {{ captured_on }}).
+- Follow the WIKI_SCHEMA. Write in the language of the page, or of the document for a new page.
+- If this part has nothing worth keeping, return an empty `pages` list.
+
+Answer with JSON following the schema: a list `pages`, each with `action` (create or update), `target_page_id` (the page_id you update, or null), `title`, `summary` (one sentence on what the page covers), `markdown` (the page body without frontmatter, starting with `# Title`) and `change_summary` (one short sentence for the page history); and a list `conflicts`, one per contradiction with what a page already said: `page_title`, `existing_statement` (what the page said, as written), `existing_source` (its attribution), `new_statement` and `new_source` ({{ source.label }}, {{ captured_on }}). An empty list when nothing contradicts.
+
+SOURCE:
+{{ source | json }}
+
+PART {{ part.index }} OF {{ part.total }}:
+{{ part.text }}
+
+WIKI_SCHEMA:
+{{ wiki_schema }}
+
+PAGE_INDEX:
+{{ page_index | json }}
+
+CANDIDATE_PAGES:
+{{ candidate_pages | json }}

iatoolkit-2.67.0/src/iatoolkit/config/system_agents/memory_image_ingest.prompt

@@ -0,0 +1,25 @@
+You maintain the company's Memory: a wiki of how things are actually done in this company (procedures, rules, exceptions, who decides). It is written from what its people explain and from the company's own documents and images.
+
+An image was loaded into Memory (SOURCE); it comes attached. Look at it and bring into the wiki what it teaches about how things are done here: the steps of a diagram, the decisions of a whiteboard, the fields and rules of a form, the values of a screenshot.
+
+- Take facts, rules, procedures, responsibilities, amounts and definitions someone in the company would need. Describe what the image says, not what it looks like.
+- If the image has nothing worth keeping (a logo, a photo of people, decoration), return an empty `pages` list.
+- Update one of the CANDIDATE_PAGES when the image belongs to its subject; create a new page when none covers it (check PAGE_INDEX first so you do not duplicate a page).
+- When you update, return the COMPLETE new page: keep everything already on it, word for word, including people's attributions.
+- When the image says something different from what a page already says, keep both statements with their attributions and list each contradiction in `conflicts`.
+- Attribute every fact you add as ({{ source.label }}, {{ captured_on }}).
+- Follow the WIKI_SCHEMA. Write in the language of the page, or of the text in the image for a new page.
+
+Answer with JSON following the schema: a list `pages`, each with `action` (create or update), `target_page_id` (the page_id you update, or null), `title`, `summary`, `markdown` (the page body without frontmatter, starting with `# Title`) and `change_summary`; and a list `conflicts` (`page_title`, `existing_statement`, `existing_source`, `new_statement`, `new_source`), empty when nothing contradicts.
+
+SOURCE:
+{{ source | json }}
+
+WIKI_SCHEMA:
+{{ wiki_schema }}
+
+PAGE_INDEX:
+{{ page_index | json }}
+
+CANDIDATE_PAGES:
+{{ candidate_pages | json }}

iatoolkit-2.67.0/src/iatoolkit/config/system_agents/memory_meeting_ingest.prompt

@@ -0,0 +1,38 @@
+You maintain the company's Memory: a wiki of how things are actually done in this company (procedures, rules, exceptions, who decides). It is written from what its people explain and from the company's own documents.
+
+A meeting transcript was loaded into Memory (SOURCE). You receive it in parts; this is part {{ part.index }} of {{ part.total }} (PART). Bring into the wiki what the meeting decided about how things are done here.
+
+What to take:
+
+- Decisions that were made ("from now on, discounts over 10% need the manager"), with who decided when the transcript says so.
+- Procedures, rules, deadlines and amounts that were agreed or explained, and who is responsible for what.
+- Not the conversation itself: no greetings, small talk, opinions that led nowhere, ideas that were only discussed, or who said what along the way.
+- Nothing personal or sensitive about the people in the meeting (health, salaries, performance, private matters), even if it was said.
+- A transcript is spoken language and may have recognition errors: write the knowledge clearly, and when a name, number or term is unclear, leave it out rather than guess.
+- An action item ("Juan will send the price list on Friday") is not knowledge on its own; keep it only when it reveals how something is done or who is responsible for it.
+
+How to write the pages:
+
+- Update one of the CANDIDATE_PAGES when the part belongs to its subject; create a new page when none covers it (check PAGE_INDEX first so you do not duplicate a page). One part may touch several pages; return each one.
+- When you update, return the COMPLETE new page: keep everything already on it, word for word, including people's attributions. Add the new facts in the section where they belong.
+- When this part says something different from what the page already says, keep both statements with their attributions and make the difference explicit; never delete what someone else said. Also list each contradiction in `conflicts`. A meeting that changes a rule is a contradiction worth showing.
+- Attribute every fact you add to the meeting: ({{ source.label }}, {{ captured_on }}).
+- Follow the WIKI_SCHEMA. Write in the language of the page, or of the transcript for a new page.
+- If this part decided or taught nothing worth keeping, return an empty `pages` list.
+
+Answer with JSON following the schema: a list `pages`, each with `action` (create or update), `target_page_id` (the page_id you update, or null), `title`, `summary` (one sentence on what the page covers), `markdown` (the page body without frontmatter, starting with `# Title`) and `change_summary` (one short sentence for the page history); and a list `conflicts`, one per contradiction with what a page already said: `page_title`, `existing_statement` (what the page said, as written), `existing_source` (its attribution), `new_statement` and `new_source` ({{ source.label }}, {{ captured_on }}). An empty list when nothing contradicts.
+
+SOURCE:
+{{ source | json }}
+
+PART {{ part.index }} OF {{ part.total }}:
+{{ part.text }}
+
+WIKI_SCHEMA:
+{{ wiki_schema }}
+
+PAGE_INDEX:
+{{ page_index | json }}
+
+CANDIDATE_PAGES:
+{{ candidate_pages | json }}

iatoolkit-2.67.0/src/iatoolkit/config/system_agents_pack.yaml

@@ -0,0 +1,314 @@
+# System agents: model calls the platform makes on its own (see
+# services/system_agent_catalog.py). The tenant may pick each one's model
+# (system_agents.<key>.model in company.yaml); the prompt, inputs and output
+# schema belong to the code that reads the answer and are not editable.
+#
+# `prompt` is a Jinja template in system_agents/, rendered with `inputs`.
+# `default_model: null` means the company's default model.
+version: 1
+
+schemas:
+  # A Memoria page created, updated or left alone.
+  memory_page:
+    type: object
+    properties:
+      action:
+        type: string
+        enum: [create, update, skip]
+      # Nullable as a type list: the structured-output validator rejects null under anyOf.
+      target_page_id:
+        type: [integer, "null"]
+      title:
+        type: string
+      summary:
+        type: string
+      markdown:
+        type: string
+      change_summary:
+        type: string
+    # Only what a page cannot do without: models often drop the optional
+    # fields, and a near miss is repaired by the compiler's normalizer.
+    required: [action, target_page_id, title, markdown]
+    additionalProperties: false
+
+  # A memory_page plus the contradictions found while writing it (BL-014).
+  memory_page_with_conflicts:
+    type: object
+    properties:
+      action:
+        type: string
+        enum: [create, update, skip]
+      target_page_id:
+        type: [integer, "null"]
+      title:
+        type: string
+      summary:
+        type: string
+      markdown:
+        type: string
+      change_summary:
+        type: string
+      conflicts:
+        type: array
+        items:
+          type: object
+          properties:
+            existing_statement:
+              type: string
+            existing_source:
+              type: string
+            new_statement:
+              type: string
+            new_source:
+              type: string
+          required: [existing_statement, new_statement]
+          additionalProperties: false
+    required: [action, target_page_id, title, markdown]
+    additionalProperties: false
+
+agents:
+  - key: memory_compiler
+    name: Compilador de Memoria
+    name_en: Memory compiler
+    description: >-
+      (Memoria de la empresa) Integra lo que la gente guarda en Memoria en la página que corresponde,
+      o crea una nueva, atribuyendo cada dato a su autor.
+    description_en: >-
+      (Company memory) Files what people save in Memory into the right page, or creates a new
+      one, attributing every fact to its author.
+    module: memory
+    prompt: memory_compiler.prompt
+    output_schema: memory_page_with_conflicts
+    inputs: [author, captured_on, wiki_schema, page_index, capture, candidate_pages]
+    default_model: null
+
+  - key: memory_correction
+    name: Corrector de Memoria
+    name_en: Memory corrector
+    description: >-
+      (Memoria de la empresa) Aplica a una página de Memoria el cambio que alguien pidió, sin tocar el
+      resto de la página.
+    description_en: >-
+      (Company memory) Applies to a Memory page the change someone asked for, leaving the rest
+      of the page as it is.
+    module: memory
+    prompt: memory_correction.prompt
+    output_schema: memory_page
+    inputs: [author, captured_on, request, page]
+    default_model: null
+
+  - key: memory_question_review
+    name: Revisión de preguntas sin respuesta
+    name_en: Unanswered questions review
+    description: >-
+      (Memoria de la empresa) Revisa las conversaciones que buscaron en Memoria o en los documentos y
+      detecta las preguntas que la IA no pudo responder.
+    description_en: >-
+      (Company memory) Reviews the conversations that searched Memory or the documents and finds
+      the questions the AI could not answer.
+    module: memory
+    prompt: memory_question_review.prompt
+    output_schema:
+      type: object
+      properties:
+        items:
+          type: array
+          items:
+            type: object
+            properties:
+              ref:
+                type: string
+              answered:
+                type: boolean
+              question:
+                type: string
+              topic:
+                type: string
+              # Nullable as a type list: core's validator rejects null under anyOf.
+              same_as_question_id:
+                type: [integer, "null"]
+              same_as_ref:
+                type: [string, "null"]
+            required: [ref, answered]
+            additionalProperties: false
+      required: [items]
+      additionalProperties: false
+    inputs: [open_questions, turns]
+    default_model: null
+
+  - key: memory_document_ingest
+    name: Lector de documentos de Memoria
+    name_en: Memory document reader
+    description: >-
+      (Memoria de la empresa) Lee los documentos que se cargan en Memoria, tramo
+      por tramo, y lleva a las páginas de la wiki lo que enseñan sobre cómo se hacen
+      las cosas, citando el documento.
+    description_en: >-
+      (Company memory) Reads the documents loaded into Memory, part by part, and
+      files into the wiki pages what they teach about how things are done, citing
+      the document.
+    module: memory
+    prompt: memory_document_ingest.prompt
+    output_schema:
+      type: object
+      properties:
+        pages:
+          type: array
+          items:
+            type: object
+            properties:
+              action:
+                type: string
+                enum: [create, update]
+              # Nullable as a type list: the structured-output validator rejects null under anyOf.
+              target_page_id:
+                type: [integer, "null"]
+              title:
+                type: string
+              summary:
+                type: string
+              markdown:
+                type: string
+              change_summary:
+                type: string
+            required: [action, target_page_id, title, markdown]
+            additionalProperties: false
+        conflicts:
+          type: array
+          items:
+            type: object
+            properties:
+              page_title:
+                type: string
+              existing_statement:
+                type: string
+              existing_source:
+                type: string
+              new_statement:
+                type: string
+              new_source:
+                type: string
+            required: [page_title, existing_statement, new_statement]
+            additionalProperties: false
+      required: [pages]
+      additionalProperties: false
+    inputs: [source, part, captured_on, wiki_schema, page_index, candidate_pages]
+    default_model: null
+
+  - key: memory_meeting_ingest
+    name: Lector de reuniones de Memoria
+    name_en: Memory meeting reader
+    description: >-
+      (Memoria de la empresa) Lee las transcripciones de reuniones de las carpetas
+      marcadas como reuniones y lleva a la wiki las decisiones, los procedimientos y
+      los responsables que se acordaron, no la conversación.
+    description_en: >-
+      (Company memory) Reads the meeting transcripts of the folders marked as
+      meetings and files into the wiki the decisions, procedures and owners agreed,
+      not the conversation.
+    module: memory
+    prompt: memory_meeting_ingest.prompt
+    output_schema:
+      type: object
+      properties:
+        pages:
+          type: array
+          items:
+            type: object
+            properties:
+              action:
+                type: string
+                enum: [create, update]
+              # Nullable as a type list: the structured-output validator rejects null under anyOf.
+              target_page_id:
+                type: [integer, "null"]
+              title:
+                type: string
+              summary:
+                type: string
+              markdown:
+                type: string
+              change_summary:
+                type: string
+            required: [action, target_page_id, title, markdown]
+            additionalProperties: false
+        conflicts:
+          type: array
+          items:
+            type: object
+            properties:
+              page_title:
+                type: string
+              existing_statement:
+                type: string
+              existing_source:
+                type: string
+              new_statement:
+                type: string
+              new_source:
+                type: string
+            required: [page_title, existing_statement, new_statement]
+            additionalProperties: false
+      required: [pages]
+      additionalProperties: false
+    inputs: [source, part, captured_on, wiki_schema, page_index, candidate_pages]
+    default_model: null
+
+  - key: memory_image_ingest
+    name: Lector de imágenes de Memoria
+    name_en: Memory image reader
+    description: >-
+      (Memoria de la empresa) Mira las imágenes que se cargan en Memoria
+      (diagramas, fotos de pizarras, capturas de pantalla, formularios) y lleva a la
+      wiki lo que enseñan sobre cómo se hacen las cosas, citando la imagen.
+    description_en: >-
+      (Company memory) Looks at the images loaded into Memory (diagrams, whiteboard
+      photos, screenshots, forms) and files into the wiki what they teach about how
+      things are done, citing the image.
+    module: memory
+    prompt: memory_image_ingest.prompt
+    requires_vision: true
+    output_schema:
+      type: object
+      properties:
+        pages:
+          type: array
+          items:
+            type: object
+            properties:
+              action:
+                type: string
+                enum: [create, update]
+              target_page_id:
+                type: [integer, "null"]
+              title:
+                type: string
+              summary:
+                type: string
+              markdown:
+                type: string
+              change_summary:
+                type: string
+            required: [action, target_page_id, title, markdown]
+            additionalProperties: false
+        conflicts:
+          type: array
+          items:
+            type: object
+            properties:
+              page_title:
+                type: string
+              existing_statement:
+                type: string
+              existing_source:
+                type: string
+              new_statement:
+                type: string
+              new_source:
+                type: string
+            required: [page_title, existing_statement, new_statement]
+            additionalProperties: false
+      required: [pages]
+      additionalProperties: false
+    inputs: [source, captured_on, wiki_schema, page_index, candidate_pages]
+    default_model: null

{iatoolkit-2.65.2 → iatoolkit-2.67.0}/src/iatoolkit/config/system_tools_pack.yaml

@@ -575,6 +575,64 @@ tools:
       required:
         - content
         - title
+  - function_name: iat_memory_pending_questions
+    description: Lista las preguntas sobre la empresa que la IA no supo responder y siguen abiertas, primero las que se le sugirieron a este usuario por ser quien más sabe del tema, después las más preguntadas. Úsala cuando el usuario pregunte qué preguntas tiene pendientes, quiera ayudar a completar la Memoria de la empresa o pida responder las preguntas de su área. Para responder una, usa `iat_memory_answer_question`.
+    routing_profile:
+      tags:
+        - memory
+        - company_memory
+        - questions
+        - pending
+        - unanswered
+      intents:
+        - List the unanswered questions the user could answer.
+        - Show the questions suggested to the user for their area.
+      examples:
+        - iat_memory_pending_questions(limit=5)
+      cost:
+        penalty: 0.1
+        latency_class: low
+        expensive: false
+    parameters:
+      type: object
+      properties:
+        limit:
+          type: integer
+          description: Cuántas preguntas listar, como máximo 15.
+      required: []
+  - function_name: iat_memory_answer_question
+    description: Responde una pregunta sin respuesta de la Memoria de la empresa (de `iat_memory_pending_questions`). La respuesta queda en la Memoria con el nombre del usuario, la ve TODA la empresa, y la pregunta deja de estar pendiente. Antes de llamarla, muéstrale al usuario el texto que vas a guardar y espera que lo confirme. Redacta `answer` en tono neutro, completo y autocontenido, con solo lo que el usuario dijo.
+    execution_config:
+      side_effects: true
+      destructive: false
+    routing_profile:
+      tags:
+        - memory
+        - company_memory
+        - questions
+        - answer
+        - know_how
+      intents:
+        - Answer an unanswered question of the company memory with what the user explained.
+        - Use only after the user confirms the text to save.
+      examples:
+        - iat_memory_answer_question(question_id=12, answer="El plazo de pago a proveedores es de 45 días desde la factura; para proveedores nuevos, 30.")
+      cost:
+        penalty: 0.1
+        latency_class: medium
+        expensive: false
+    parameters:
+      type: object
+      properties:
+        question_id:
+          type: integer
+          description: El id de la pregunta, de `iat_memory_pending_questions`.
+        answer:
+          type: string
+          description: La respuesta, redactada en tono neutro y autocontenida (debe entenderse sin la conversación).
+      required:
+        - question_id
+        - answer
   - function_name: iat_image_search
     description: Busca imágenes en la base de conocimiento visual de la empresa usando una descripción de texto. Útil cuando el usuario pide 'ver' algo, 'muéstrame una foto de...', o busca gráficos y diagramas.
     routing:

{iatoolkit-2.65.2 → iatoolkit-2.67.0}/src/iatoolkit/infra/connectors/local_file_connector.py

@@ -91,5 +91,7 @@ class LocalFileConnector(FileConnector):
             raise IAToolkitException(IAToolkitException.ErrorType.FILE_IO_ERROR,
                                      f"Error eliminando el archivo {file_path}: {e}")
 
-    def generate_presigned_url(self, file_path: str, expiration: int = 3600) -> str:
-        raise NotImplementedError("not implemented yet")
+    def generate_presigned_url(self, file_path: str, expiration: int = 3600) -> str | None:
+        # FileConnector allows None when storage has no external URL. RAG
+        # results can still return their text, and Flask streams downloads.
+        return None

{iatoolkit-2.65.2 → iatoolkit-2.67.0}/src/iatoolkit/locales/en.yaml

@@ -362,6 +362,7 @@ ui:
     profile: "Profile"
     preferences: "Preferences"
     connections: "Connections"
+    memory_questions: "Questions for me"
     first_name: "First name"
     last_name: "Last name"
     full_name: "Full name"

{iatoolkit-2.65.2 → iatoolkit-2.67.0}/src/iatoolkit/locales/es.yaml

@@ -376,6 +376,7 @@ ui:
     profile: "Perfil"
     preferences: "Preferencias"
     connections: "Conexiones"
+    memory_questions: "Preguntas para mí"
     first_name: "Nombre"
     last_name: "Apellido"
     full_name: "Nombre completo"

{iatoolkit-2.65.2 → iatoolkit-2.67.0}/src/iatoolkit/repositories/memory_repo.py

@@ -9,7 +9,9 @@ from iatoolkit.repositories.database_manager import DatabaseManager
 from iatoolkit.repositories.models import (
     MemoryCapture,
     MemoryCaptureStatus,
+    MemoryConflict,
     MemoryItem,
+    MemoryPageDocument,
     MemoryWikiPageSource,
 )
 
@@ -167,6 +169,93 @@ class MemoryRepo:
         )
         return [page_id for (page_id,) in rows]
 
+    def add_page_document(self, company_id: int, wiki_page_id: int, document_id: int, label: str | None) -> None:
+        """Records that a page took facts from a RAG document (BL-014); keeps one link per pair."""
+        if not company_id or not wiki_page_id or not document_id:
+            return
+        link = (
+            self.session.query(MemoryPageDocument)
+            .filter_by(wiki_page_id=wiki_page_id, document_id=document_id)
+            .first()
+        )
+        if link is None:
+            self.session.add(MemoryPageDocument(
+                company_id=company_id,
+                wiki_page_id=wiki_page_id,
+                document_id=document_id,
+                label=(label or "")[:300] or None,
+            ))
+        elif label and link.label != label:
+            link.label = label[:300]
+        self.session.commit()
+
+    def list_page_ids_for_document(self, company_id: int, document_id: int) -> list[int]:
+        if not company_id or not document_id:
+            return []
+        rows = (
+            self.session.query(MemoryPageDocument.wiki_page_id)
+            .filter_by(company_id=company_id, document_id=document_id)
+            .order_by(MemoryPageDocument.id.asc())
+            .all()
+        )
+        return [page_id for (page_id,) in rows]
+
+    def list_page_documents(self, wiki_page_id: int) -> list[MemoryPageDocument]:
+        if not wiki_page_id:
+            return []
+        return (
+            self.session.query(MemoryPageDocument)
+            .filter_by(wiki_page_id=wiki_page_id)
+            .order_by(MemoryPageDocument.id.asc())
+            .all()
+        )
+
+    def list_document_links(self, company_id: int, document_id: int) -> list[MemoryPageDocument]:
+        if not company_id or not document_id:
+            return []
+        return (
+            self.session.query(MemoryPageDocument)
+            .filter_by(company_id=company_id, document_id=document_id)
+            .order_by(MemoryPageDocument.id.asc())
+            .all()
+        )
+
+    def list_obsolete_page_documents(self, company_id: int, limit: int = 50) -> list[MemoryPageDocument]:
+        """Pages that cite a deleted document and nobody reviewed yet."""
+        if not company_id:
+            return []
+        return (
+            self.session.query(MemoryPageDocument)
+            .filter(MemoryPageDocument.company_id == company_id,
+                    MemoryPageDocument.removed_at.isnot(None),
+                    MemoryPageDocument.reviewed_at.is_(None))
+            .order_by(MemoryPageDocument.removed_at.desc())
+            .limit(limit)
+            .all()
+        )
+
+    def get_page_document(self, company_id: int, link_id: int) -> MemoryPageDocument | None:
+        return self.session.query(MemoryPageDocument).filter_by(company_id=company_id, id=link_id).first()
+
+    def add_conflict(self, conflict: MemoryConflict) -> MemoryConflict:
+        self.session.add(conflict)
+        self.session.commit()
+        return conflict
+
+    def list_open_conflicts(self, company_id: int, limit: int = 50) -> list[MemoryConflict]:
+        if not company_id:
+            return []
+        return (
+            self.session.query(MemoryConflict)
+            .filter_by(company_id=company_id, status=MemoryConflict.STATUS_OPEN)
+            .order_by(MemoryConflict.created_at.desc())
+            .limit(limit)
+            .all()
+        )
+
+    def get_conflict(self, company_id: int, conflict_id: int) -> MemoryConflict | None:
+        return self.session.query(MemoryConflict).filter_by(company_id=company_id, id=conflict_id).first()
+
     def delete_page_sources_for_item(self, item_id: int) -> None:
         """Unlinks an item from every page. The pages themselves are never touched."""
         if not item_id: