iatoolkit 2.58.2__tar.gz → 2.59.0__tar.gz

{iatoolkit-2.58.2/src/iatoolkit.egg-info → iatoolkit-2.59.0}/PKG-INFO

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

{iatoolkit-2.58.2 → iatoolkit-2.59.0}/src/iatoolkit/__init__.py

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

iatoolkit-2.59.0/src/iatoolkit/config/system_prompts/memory_usage.prompt

@@ -0,0 +1,20 @@
+### Memoria de la empresa
+
+- La empresa tiene una Memoria: páginas con cómo se hacen las cosas aquí
+  (procedimientos, reglas, excepciones, quién decide), escritas a partir de lo
+  que su gente explicó. Cada dato indica quién lo dijo y cuándo.
+- Usa `iat_memory_search` antes de responder cómo se hace algo en la empresa o
+  cuando la respuesta dependa de prácticas internas. Usa `iat_memory_get_page`
+  para leer una página completa cuando lo necesites; si un resultado trae
+  `has_native_files=true` y el contenido del archivo importa, léela antes de
+  responder.
+- Cuando uses la Memoria, menciona de quién y de cuándo es el dato
+  ("según Carmen, marzo 2026"), porque los procesos cambian.
+- Si la Memoria contradice a un documento, muestra las dos versiones con su
+  fuente; no elijas en silencio.
+- Cuando el usuario te explique cómo se hace algo o te corrija ("no, eso se
+  hace así"), ofrécele guardarlo en la Memoria de la empresa. Si acepta o te lo
+  pide ("guarda esto"), avísale que lo verá toda la empresa con su nombre y usa
+  `iat_memory_save`, con el contenido redactado en tono neutro y autocontenido.
+- No guardes en la Memoria preferencias personales, recordatorios ni datos
+  sensibles que no sirvan al procedimiento.

{iatoolkit-2.58.2 → iatoolkit-2.59.0}/src/iatoolkit/config/system_tools_pack.yaml

@@ -372,35 +372,29 @@ tools:
         - 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".
+    description: Busca en la Memoria de la empresa, el conocimiento de cómo se hacen las cosas en esta empresa que su gente fue guardando (procedimientos, reglas, excepciones, quién decide, correcciones a documentos). Devuelve páginas con título, resumen y fuentes. Incluye la señal `has_native_files` cuando una página tiene archivos fuente que pueden adjuntarse nativamente al modelo. Úsala antes de responder cómo se hace algo en la empresa, o cuando la pregunta dependa de prácticas internas que podrían no estar en los documentos.
     routing:
       force_include_capability: has_user_memory
     routing_profile:
       tags:
         - memory
-        - personal_context
-        - notes
-        - saved_notes
+        - company_memory
+        - know_how
+        - procedures
+        - internal_practices
+        - corrections
         - saved_content
-        - plans
-        - ideas
-        - work_in_progress
-        - continuity
-        - weekly_focus
         - wiki
       intents:
-        - Search the user's personal memory pages for relevant context.
-        - Retrieve compiled personal notes, saved chat context, and remembered plans or ideas.
-        - Retrieve what the user was planning, working on, or wanted to implement.
-        - Search saved personal context about ideas, tasks, plans, priorities, and previous chat notes.
-        - Use this before answering questions about what the user saved, discussed, planned, or was working on earlier.
+        - Search the company memory for how things are done here.
+        - Retrieve internal procedures, rules, exceptions and who decides, as people in the company explained them.
+        - Check whether people corrected or completed what a company document says.
+        - Use this before answering how something is done in this company.
       examples:
-        - iat_memory_search(query="ideas sobre onboarding", limit=5)
-        - iat_memory_search(query="lo que guardé del cliente acme", limit=3)
-        - iat_memory_search(query="qué tengo pensado para implementar esta semana en iatoolkit", limit=5)
-        - iat_memory_search(query="en qué estoy trabajando ahora", limit=5)
-        - iat_memory_search(query="qué ideas guardé sobre agentes y memorias", limit=5)
-        - iat_memory_search(query="what was I planning to implement this week", limit=5)
+        - iat_memory_search(query="cómo se emite una nota de crédito", limit=5)
+        - iat_memory_search(query="despachos a regiones los viernes", limit=3)
+        - iat_memory_search(query="quién aprueba descuentos sobre 10%", limit=5)
+        - iat_memory_search(query="plazo real de pago de clientes grandes", limit=5)
       cost:
         penalty: 0.08
         latency_class: medium
@@ -410,7 +404,7 @@ tools:
       properties:
         query:
           type: string
-          description: Texto que describe lo que deseas recuperar desde Memoria.
+          description: Texto que describe lo que deseas recuperar desde la Memoria de la empresa.
         limit:
           type: integer
           description: Cantidad máxima de páginas a recuperar.
@@ -420,18 +414,18 @@ tools:
         - query
         - limit
   - function_name: iat_memory_get_page
-    description: Recupera una página completa de la Memoria personal del usuario, incluyendo resumen, decisiones, próximos pasos y fuentes. Si la página proviene de capturas con archivos adjuntos compatibles, esos archivos pueden quedar adjuntos nativamente al turno actual del modelo para inspección directa; en ese caso no hace falta pedir permiso para abrir un access_url temporal. Si `iat_memory_search` devuelve `has_native_files=true` y la respuesta depende del contenido del archivo, debes llamar esta tool antes de responder.
+    description: Recupera una página completa de la Memoria de la empresa, en markdown, con autor y fecha de cada dato y sus fuentes. Si la página proviene de capturas con archivos adjuntos compatibles, esos archivos pueden quedar adjuntos nativamente al turno actual del modelo para inspección directa; en ese caso no hace falta pedir permiso para abrir un access_url temporal. Si `iat_memory_search` devuelve `has_native_files=true` y la respuesta depende del contenido del archivo, debes llamar esta tool antes de responder.
     routing:
       force_include_capability: has_user_memory
     routing_profile:
       tags:
         - memory
+        - company_memory
         - page
-        - compiled_context
         - wiki
       intents:
-        - Open a compiled memory page by id.
-        - Read the full content of a personal memory page before answering.
+        - Open a company memory page by id.
+        - Read the full content of a company memory page before answering.
       examples:
         - iat_memory_get_page(page_id=12)
       cost:
@@ -443,9 +437,49 @@ tools:
       properties:
         page_id:
           type: integer
-          description: Identificador de la página de Memoria a recuperar.
+          description: Identificador de la página de la Memoria de la empresa, devuelto por `iat_memory_search`.
       required:
         - page_id
+  - function_name: iat_memory_save
+    description: Guarda en la Memoria de la empresa algo que el usuario explicó sobre cómo se hacen las cosas en la empresa (un procedimiento, una regla, una excepción, quién decide) o una corrección a lo que dice un documento o a una respuesta tuya. Lo verá TODA la empresa, con el nombre del usuario y la fecha, y se publica de inmediato. Úsala solo cuando el usuario pida guardarlo ("guarda esto", "que lo sepa la empresa") o acepte cuando le ofreces guardarlo tras corregirte. Antes de llamarla, dile al usuario que lo verá toda la empresa. Redacta `content` en tono neutro e impersonal, con solo el conocimiento útil, sin datos personales ni sensibles que no sirvan al procedimiento. No la uses para preferencias o recordatorios personales.
+    # Publishes to the whole company: simulated when an evaluation replays an
+    # agent, and marked as a write for MCP clients so they ask the user first.
+    execution_config:
+      side_effects: true
+      destructive: false
+    routing:
+      force_include_capability: has_user_memory
+    routing_profile:
+      tags:
+        - memory
+        - company_memory
+        - save
+        - capture
+        - know_how
+        - corrections
+      intents:
+        - Save what the user explained about how things are done in the company.
+        - Save a correction the user made to a document or to an answer.
+        - Use only when the user asks to save it or accepts the offer to save it.
+      examples:
+        - iat_memory_save(content="Al cliente Transportes Sur no se le despacha los viernes; la bodega cierra temprano ese día.", title="Despachos a Transportes Sur")
+        - iat_memory_save(content="Las notas de crédito las aprueba Andrea Rojas; si no está, la gerencia.", title="Aprobación de notas de crédito")
+      cost:
+        penalty: 0.1
+        latency_class: medium
+        expensive: false
+    parameters:
+      type: object
+      properties:
+        content:
+          type: string
+          description: El conocimiento a guardar, redactado en tono neutro, completo y autocontenido (debe entenderse sin la conversación).
+        title:
+          type: string
+          description: Título corto del tema, por ejemplo "Notas de crédito".
+      required:
+        - content
+        - title
   - 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.58.2 → iatoolkit-2.59.0}/src/iatoolkit/core.py

@@ -399,9 +399,7 @@ class IAToolkit:
         from iatoolkit.repositories.filesystem_asset_repository import FileSystemAssetRepository
         from iatoolkit.repositories.env_secret_provider import EnvSecretProvider
         from iatoolkit.common.interfaces.memory_compilation_trigger import MemoryCompilationTrigger
-        from iatoolkit.common.interfaces.memory_lint_trigger import MemoryLintTrigger
         from iatoolkit.services.noop_memory_compilation_trigger import NoopMemoryCompilationTrigger
-        from iatoolkit.services.noop_memory_lint_trigger import NoopMemoryLintTrigger
         from iatoolkit.services.memory_lookup_policy_service import MemoryLookupPolicyService
 
         binder.bind(ApiKeyRepo, to=ApiKeyRepo)
@@ -423,8 +421,6 @@ class IAToolkit:
             binder.bind(SecretProvider, to=EnvSecretProvider)
         if not is_bound(self._injector, MemoryCompilationTrigger):
             binder.bind(MemoryCompilationTrigger, to=NoopMemoryCompilationTrigger)
-        if not is_bound(self._injector, MemoryLintTrigger):
-            binder.bind(MemoryLintTrigger, to=NoopMemoryLintTrigger)
         binder.bind(MemoryLookupPolicyService, to=MemoryLookupPolicyService)
 
     def _bind_services(self, binder: Binder):

{iatoolkit-2.58.2 → iatoolkit-2.59.0}/src/iatoolkit/locales/en.yaml

@@ -378,26 +378,25 @@ ui:
     never_used: "No recorded use"
 
   memory:
-    title: "Memory"
-    capture_title: "Save something"
-    capture_helper: "Write a note, paste a link, or add photos and documents to keep them in Memory."
-    capture_label: "Your capture"
-    capture_placeholder: "Write an idea, reminder, or paste a useful link here"
+    title: "Company memory"
+    capture_title: "Teach the company something"
+    capture_helper: "Explain how something is done, correct a fact, or attach a document. Everyone in the company will see it, with your name and the date."
+    capture_label: "What you want to save"
+    capture_placeholder: "For example: customer X never gets deliveries on Fridays"
     file_label: "Photos and documents"
     save_capture: "Save to Memory"
     cancel_edit: "Cancel editing"
-    tab_recent: "Captures"
-    tab_recent_helper: "Notes, links, and files you saved"
-    tab_memories: "Summary"
-    tab_memories_helper: "What Memory organized from those captures"
+    tab_recent: "My contributions"
+    tab_recent_helper: "What you saved"
+    tab_memories: "What we know"
+    tab_memories_helper: "The pages of the company memory"
     loading: "Loading..."
     loading_dashboard: "Loading Memory..."
-    empty_recent: "You haven't saved anything to Memory yet."
-    empty_memories: "There are no compiled summaries yet."
+    empty_recent: "You haven't contributed to the company memory yet."
+    empty_memories: "The company memory has no pages yet."
     delete_modal_title: "Delete from Memory"
-    delete_modal_body: "Delete this item from Memory?"
+    delete_modal_body: "Delete this contribution? The pages built from it are kept."
     delete_confirm_button: "Delete"
-    run_lint: "Review Memory"
 
   campaigns:
     title: "Campaigns"
@@ -2535,7 +2534,7 @@ ui:
 
   tooltips:
     history: "History of my queries"
-    memory: "Memory"
+    memory: "Company memory"
     reload_context: "Force Context Reload"
     feedback: "Your feedback is very important"
     usage_guide: "Usage Guide"
@@ -2748,24 +2747,12 @@ js_messages:
   memory_file_required: "Select at least one file or photo."
   memory_open_error: "Could not open the memory."
   memory_save_error: "Could not save to Memory."
-  memory_save_success: "Saved to Memory"
+  memory_save_success: "Saved to the company memory. Everyone in the company will see it, with your name."
   memory_load_error: "Could not load Memory."
   memory_capture_open_resource: "Open"
   memory_editing_capture: "Editing saved capture"
   memory_save_capture: "Save to Memory"
   memory_save_capture_changes: "Save changes"
-  memory_lint_error: "Could not review Memory."
-  memory_lint_running: "Reviewing..."
-  memory_lint_scheduled: "Memory review scheduled"
-  memory_lint_success: "Memory review completed"
-  memory_lint_last_title: "Latest review"
-  memory_lint_action: "Review memory"
-  memory_lint_never_reviewed: "No reviews have been run yet."
-  memory_lint_never_timestamp: "No reviews yet"
-  memory_lint_checked: "{count} pages checked"
-  memory_lint_actions: "{count} fixes applied"
-  memory_lint_duplicates: "{count} possible duplicates"
-  memory_lint_orphans: "{count} orphan pages"
   memory_page_card_label: "Page"
   memory_edit_item_title: "Edit capture"
   memory_remove_item: "Remove"

{iatoolkit-2.58.2 → iatoolkit-2.59.0}/src/iatoolkit/locales/es.yaml

@@ -392,26 +392,25 @@ ui:
     never_used: "Sin uso registrado"
 
   memory:
-    title: "Memoria"
-    capture_title: "Guardar algo"
-    capture_helper: "Escribe una nota, pega un link o añade fotos y documentos para guardarlos en Memoria."
-    capture_label: "Tu captura"
-    capture_placeholder: "Escribe una idea, recordatorio o pega aquí un link útil"
+    title: "Memoria de la empresa"
+    capture_title: "Enseñar algo a la empresa"
+    capture_helper: "Explica cómo se hace algo, corrige un dato o adjunta un documento. Lo verá toda la empresa, con tu nombre y la fecha."
+    capture_label: "Lo que quieres guardar"
+    capture_placeholder: "Por ejemplo: al cliente X nunca se le despacha los viernes"
     file_label: "Fotos y documentos"
     save_capture: "Guardar en Memoria"
     cancel_edit: "Cancelar edición"
-    tab_recent: "Capturas"
-    tab_recent_helper: "Notas, links y archivos que guardaste"
-    tab_memories: "Resumen"
-    tab_memories_helper: "Lo que Memoria organizó a partir de eso"
+    tab_recent: "Mis aportes"
+    tab_recent_helper: "Lo que tú guardaste"
+    tab_memories: "Lo que sabemos"
+    tab_memories_helper: "Las páginas de la memoria de la empresa"
     loading: "Cargando..."
     loading_dashboard: "Cargando Memoria..."
-    empty_recent: "Todavía no has guardado nada en Memoria."
-    empty_memories: "Aún no hay resúmenes compilados."
+    empty_recent: "Todavía no has aportado nada a la memoria de la empresa."
+    empty_memories: "La memoria de la empresa todavía no tiene páginas."
     delete_modal_title: "Eliminar de Memoria"
-    delete_modal_body: "¿Eliminar este elemento de Memoria?"
+    delete_modal_body: "¿Eliminar este aporte? Las páginas que se armaron con él se mantienen."
     delete_confirm_button: "Eliminar"
-    run_lint: "Revisar Memoria"
 
   campaigns:
     title: "Campañas"
@@ -2551,7 +2550,7 @@ ui:
 
   tooltips:
     history: "Historial con mis consultas"
-    memory: "Memoria"
+    memory: "Memoria de la empresa"
     reload_context: "Forzar Recarga de Contexto"
     feedback: "Tu feedback es muy importante"
     usage_guide: "Guía de Uso"
@@ -2767,24 +2766,12 @@ js_messages:
   memory_file_required: "Selecciona al menos un archivo o foto."
   memory_open_error: "No se pudo abrir la memoria."
   memory_save_error: "No se pudo guardar en Memoria."
-  memory_save_success: "Guardado en Memoria"
+  memory_save_success: "Guardado en la memoria de la empresa. Lo verá toda la empresa, con tu nombre."
   memory_load_error: "No se pudo cargar Memoria."
   memory_capture_open_resource: "Abrir"
   memory_editing_capture: "Editando captura guardada"
   memory_save_capture: "Guardar en Memoria"
   memory_save_capture_changes: "Guardar cambios"
-  memory_lint_error: "No se pudo revisar la Memoria."
-  memory_lint_running: "Revisando..."
-  memory_lint_scheduled: "Revisión de Memoria programada"
-  memory_lint_success: "Revisión de Memoria completada"
-  memory_lint_last_title: "Última revisión"
-  memory_lint_action: "Revisar memoria"
-  memory_lint_never_reviewed: "Aún no hay revisiones registradas."
-  memory_lint_never_timestamp: "Sin revisiones"
-  memory_lint_checked: "{count} páginas revisadas"
-  memory_lint_actions: "{count} ajustes aplicados"
-  memory_lint_duplicates: "{count} posibles duplicados"
-  memory_lint_orphans: "{count} huérfanas"
   memory_page_card_label: "Página"
   memory_edit_item_title: "Editar captura"
   memory_remove_item: "Quitar"

{iatoolkit-2.58.2 → iatoolkit-2.59.0}/src/iatoolkit/repositories/knowledge_wiki_repo.py

@@ -108,6 +108,15 @@ class KnowledgeWikiRepo:
             .first()
         )
 
+    def get_page_by_id(self, wiki_id: int, page_id: int) -> KnowledgeWikiPage | None:
+        if not wiki_id or not page_id:
+            return None
+        return (
+            self.session.query(KnowledgeWikiPage)
+            .filter_by(wiki_id=wiki_id, id=page_id)
+            .first()
+        )
+
     def get_page_by_slug(self, wiki_id: int, slug: str) -> KnowledgeWikiPage | None:
         if not wiki_id or not slug:
             return None
@@ -272,6 +281,15 @@ class KnowledgeWikiRepo:
             .all()
         )
 
+    def get_page_revision(self, wiki_id: int, revision_id: int) -> KnowledgeWikiPageRevision | None:
+        if not wiki_id or not revision_id:
+            return None
+        return (
+            self.session.query(KnowledgeWikiPageRevision)
+            .filter_by(wiki_id=wiki_id, id=revision_id)
+            .first()
+        )
+
     def archive_pages_not_in_paths(self, wiki_id: int, paths: set[str]) -> int:
         if not wiki_id:
             return 0

iatoolkit-2.59.0/src/iatoolkit/repositories/memory_repo.py

@@ -0,0 +1,192 @@
+# Copyright (c) 2024 Fernando Libedinsky
+# Product: IAToolkit
+#
+# IAToolkit is open source software.
+
+from injector import inject
+
+from iatoolkit.repositories.database_manager import DatabaseManager
+from iatoolkit.repositories.models import (
+    MemoryCapture,
+    MemoryCaptureStatus,
+    MemoryItem,
+    MemoryWikiPageSource,
+)
+
+
+class MemoryRepo:
+    """
+    Memoria is the company's memory: captures and items belong to the company,
+    and `user_identifier` on them records who saved them (the author). Methods
+    that take a `user_identifier` restrict to that author's own captures, which
+    is what a user may edit or delete; the rest are company-wide.
+    """
+
+    @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 create_item(self, item: MemoryItem) -> MemoryItem:
+        self.session.add(item)
+        self.session.commit()
+        return item
+
+    def create_capture(self, capture: MemoryCapture) -> MemoryCapture:
+        self.session.add(capture)
+        self.session.commit()
+        return capture
+
+    def save_capture(self, capture: MemoryCapture) -> MemoryCapture:
+        self.session.add(capture)
+        self.session.commit()
+        return capture
+
+    def save_item(self, item: MemoryItem) -> MemoryItem:
+        self.session.add(item)
+        self.session.commit()
+        return item
+
+    def get_item(self, company_id: int, item_id: int, user_identifier: str | None = None) -> MemoryItem | None:
+        if not company_id or not item_id:
+            return None
+        query = self.session.query(MemoryItem).filter_by(company_id=company_id, id=item_id)
+        if user_identifier is not None:
+            query = query.filter_by(user_identifier=user_identifier)
+        return query.first()
+
+    def get_capture(self, company_id: int, capture_id: int, user_identifier: str | None = None) -> MemoryCapture | None:
+        if not company_id or not capture_id:
+            return None
+        query = self.session.query(MemoryCapture).filter_by(company_id=company_id, id=capture_id)
+        if user_identifier is not None:
+            query = query.filter_by(user_identifier=user_identifier)
+        return query.first()
+
+    def list_capture_items(self, capture_id: int) -> list[MemoryItem]:
+        if not capture_id:
+            return []
+        return (
+            self.session.query(MemoryItem)
+            .filter_by(capture_id=capture_id)
+            .order_by(MemoryItem.created_at.asc(), MemoryItem.id.asc())
+            .all()
+        )
+
+    def list_items_by_ids(self, company_id: int, item_ids: list[int]) -> list[MemoryItem]:
+        normalized_ids = [item_id for item_id in (item_ids or []) if isinstance(item_id, int)]
+        if not company_id or not normalized_ids:
+            return []
+        return (
+            self.session.query(MemoryItem)
+            .filter(
+                MemoryItem.company_id == company_id,
+                MemoryItem.id.in_(normalized_ids),
+            )
+            .all()
+        )
+
+    def list_recent_captures(self,
+                             company_id: int,
+                             user_identifier: str | None = None,
+                             limit: int = 25) -> list[MemoryCapture]:
+        if not company_id:
+            return []
+        query = self.session.query(MemoryCapture).filter_by(company_id=company_id)
+        if user_identifier is not None:
+            query = query.filter_by(user_identifier=user_identifier)
+        return (
+            query
+            .order_by(MemoryCapture.created_at.desc(), MemoryCapture.id.desc())
+            .limit(limit)
+            .all()
+        )
+
+    def list_recent_items(self, company_id: int, limit: int = 25) -> list[MemoryItem]:
+        if not company_id:
+            return []
+        return (
+            self.session.query(MemoryItem)
+            .filter_by(company_id=company_id)
+            .order_by(MemoryItem.created_at.desc(), MemoryItem.id.desc())
+            .limit(limit)
+            .all()
+        )
+
+    def get_pending_captures(self, company_id: int, limit: int = 25) -> list[MemoryCapture]:
+        if not company_id:
+            return []
+        return (
+            self.session.query(MemoryCapture)
+            .filter_by(company_id=company_id, status=MemoryCaptureStatus.PENDING)
+            .order_by(MemoryCapture.created_at.asc(), MemoryCapture.id.asc())
+            .limit(limit)
+            .all()
+        )
+
+    def add_page_sources(self, company_id: int, wiki_page_id: int, item_ids: list[int]) -> None:
+        """Links items to a wiki page, keeping the links it already has."""
+        if not company_id or not wiki_page_id:
+            return
+        existing = set(self.list_page_source_item_ids(wiki_page_id))
+        for item_id in item_ids or []:
+            if isinstance(item_id, int) and item_id not in existing:
+                self.session.add(MemoryWikiPageSource(
+                    company_id=company_id,
+                    wiki_page_id=wiki_page_id,
+                    memory_item_id=item_id,
+                ))
+                existing.add(item_id)
+        self.session.commit()
+
+    def list_page_source_item_ids(self, wiki_page_id: int) -> list[int]:
+        if not wiki_page_id:
+            return []
+        rows = (
+            self.session.query(MemoryWikiPageSource.memory_item_id)
+            .filter_by(wiki_page_id=wiki_page_id)
+            .order_by(MemoryWikiPageSource.id.asc())
+            .all()
+        )
+        return [item_id for (item_id,) in rows]
+
+    def list_page_ids_for_items(self, item_ids: list[int]) -> list[int]:
+        normalized_ids = [item_id for item_id in (item_ids or []) if isinstance(item_id, int)]
+        if not normalized_ids:
+            return []
+        rows = (
+            self.session.query(MemoryWikiPageSource.wiki_page_id)
+            .filter(MemoryWikiPageSource.memory_item_id.in_(normalized_ids))
+            .distinct()
+            .all()
+        )
+        return [page_id for (page_id,) in rows]
+
+    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:
+            return
+        (
+            self.session.query(MemoryWikiPageSource)
+            .filter_by(memory_item_id=item_id)
+            .delete(synchronize_session=False)
+        )
+        self.session.commit()
+
+    def delete_capture(self, capture: MemoryCapture) -> None:
+        if not capture:
+            return
+        self.session.delete(capture)
+        self.session.commit()
+
+    def delete_item(self, item: MemoryItem) -> None:
+        if not item:
+            return
+        self.delete_page_sources_for_item(item.id)
+        self.session.delete(item)
+        self.session.commit()