maximem-synap-semantic-kernel 0.1.1__py3-none-any.whl

maximem_synap_semantic_kernel-0.1.1.dist-info/METADATA

@@ -0,0 +1,12 @@
+Metadata-Version: 2.4
+Name: maximem-synap-semantic-kernel
+Version: 0.1.1
+Summary: Synap memory integration for Microsoft Semantic Kernel
+License-Expression: Apache-2.0
+Requires-Python: >=3.11
+Requires-Dist: maximem-synap>=0.2.0
+Requires-Dist: synap-integrations-common>=0.1.0
+Requires-Dist: semantic-kernel>=1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"

maximem_synap_semantic_kernel-0.1.1.dist-info/RECORD

@@ -0,0 +1,6 @@
+synap_semantic_kernel/__init__.py,sha256=S808aSAJ-DHyL9ByoQIfs7Ua4hyeMNEj3IPzkPoQfn0,143
+synap_semantic_kernel/plugin.py,sha256=vOhFzDC4wZFh8ydNsSYgN9knG2X0i7tS8ao11hF5tgo,2911
+maximem_synap_semantic_kernel-0.1.1.dist-info/METADATA,sha256=ZGwjklCAURZXpdGvKtiwEPrOjYyoC5Zp_nl3SwehnCo,427
+maximem_synap_semantic_kernel-0.1.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+maximem_synap_semantic_kernel-0.1.1.dist-info/top_level.txt,sha256=je8evgxmID56j5mtSX-1Z_xs3YMl7IH8MZuFvW6AqnA,22
+maximem_synap_semantic_kernel-0.1.1.dist-info/RECORD,,

maximem_synap_semantic_kernel-0.1.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

maximem_synap_semantic_kernel-0.1.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+synap_semantic_kernel

synap_semantic_kernel/__init__.py

@@ -0,0 +1,5 @@
+"""Synap memory integration for Microsoft Semantic Kernel."""
+
+from synap_semantic_kernel.plugin import SynapPlugin
+
+__all__ = ["SynapPlugin"]

synap_semantic_kernel/plugin.py

@@ -0,0 +1,93 @@
+"""Synap plugin for Microsoft Semantic Kernel.
+
+Exposes Synap memory as kernel functions (search_memory, store_memory)
+that can be registered with a Semantic Kernel instance.
+"""
+
+import logging
+from typing import Annotated, Optional
+
+from semantic_kernel.functions import kernel_function
+
+from maximem_synap import MaximemSynapSDK
+from synap_integrations_common import wrap_sdk_errors_async
+
+logger = logging.getLogger(__name__)
+
+
+class SynapPlugin:
+    """Semantic Kernel plugin for Synap memory operations.
+
+    Example::
+
+        from semantic_kernel import Kernel
+        from synap_semantic_kernel import SynapPlugin
+
+        kernel = Kernel()
+        kernel.add_plugin(
+            SynapPlugin(sdk=sdk, user_id="u1"),
+            plugin_name="synap",
+        )
+    """
+
+    def __init__(
+        self,
+        sdk: MaximemSynapSDK,
+        user_id: str,
+        customer_id: str = "",
+        conversation_id: Optional[str] = None,
+    ):
+        if sdk is None:
+            raise ValueError("SynapPlugin requires a non-None sdk")
+        if not user_id:
+            raise ValueError("SynapPlugin requires a non-empty user_id")
+
+        self._sdk = sdk
+        self._user_id = user_id
+        self._customer_id = customer_id
+        self._conversation_id = conversation_id
+
+    @kernel_function(
+        name="search_memory",
+        description=(
+            "Search the user's memory for relevant context. Use when you need "
+            "to recall past conversations, preferences, or facts about the user."
+        ),
+    )
+    async def search_memory(
+        self,
+        query: Annotated[str, "Natural language search query"],
+    ) -> str:
+        async with wrap_sdk_errors_async(
+            "semantic_kernel.search_memory", logger, user_id=self._user_id,
+        ):
+            response = await self._sdk.fetch(
+                conversation_id=self._conversation_id,
+                user_id=self._user_id,
+                customer_id=self._customer_id or None,
+                search_query=[query],
+                mode="accurate",
+                include_conversation_context=False,
+            )
+        return response.formatted_context or "No relevant memories found."
+
+    @kernel_function(
+        name="store_memory",
+        description=(
+            "Store an important fact, preference, or event about the user "
+            "for future reference."
+        ),
+    )
+    async def store_memory(
+        self,
+        content: Annotated[str, "Information to remember about the user"],
+    ) -> str:
+        async with wrap_sdk_errors_async(
+            "semantic_kernel.store_memory", logger, user_id=self._user_id,
+        ):
+            result = await self._sdk.memories.create(
+                document=content,
+                user_id=self._user_id,
+                customer_id=self._customer_id,
+            )
+        return f"Memory stored (ingestion_id: {result.ingestion_id})"