maximem-synap-semantic-kernel 0.1.1__tar.gz

maximem_synap_semantic_kernel-0.1.1/PKG-INFO

@@ -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/maximem_synap_semantic_kernel.egg-info/PKG-INFO

@@ -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/maximem_synap_semantic_kernel.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+pyproject.toml
+maximem_synap_semantic_kernel.egg-info/PKG-INFO
+maximem_synap_semantic_kernel.egg-info/SOURCES.txt
+maximem_synap_semantic_kernel.egg-info/dependency_links.txt
+maximem_synap_semantic_kernel.egg-info/requires.txt
+maximem_synap_semantic_kernel.egg-info/top_level.txt
+synap_semantic_kernel/__init__.py
+synap_semantic_kernel/plugin.py
+tests/test_plugin.py

maximem_synap_semantic_kernel-0.1.1/maximem_synap_semantic_kernel.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

maximem_synap_semantic_kernel-0.1.1/maximem_synap_semantic_kernel.egg-info/requires.txt

@@ -0,0 +1,7 @@
+maximem-synap>=0.2.0
+synap-integrations-common>=0.1.0
+semantic-kernel>=1.0
+
+[dev]
+pytest>=7.0
+pytest-asyncio>=0.21

maximem_synap_semantic_kernel-0.1.1/maximem_synap_semantic_kernel.egg-info/top_level.txt

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

maximem_synap_semantic_kernel-0.1.1/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "maximem-synap-semantic-kernel"
+version = "0.1.1"
+description = "Synap memory integration for Microsoft Semantic Kernel"
+requires-python = ">=3.11"
+license = "Apache-2.0"
+dependencies = ["maximem-synap>=0.2.0", "synap-integrations-common>=0.1.0", "semantic-kernel>=1.0"]
+
+[project.optional-dependencies]
+dev = ["pytest>=7.0", "pytest-asyncio>=0.21"]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["synap_semantic_kernel*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"

maximem_synap_semantic_kernel-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

maximem_synap_semantic_kernel-0.1.1/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"]

maximem_synap_semantic_kernel-0.1.1/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})"

maximem_synap_semantic_kernel-0.1.1/tests/test_plugin.py

@@ -0,0 +1,53 @@
+"""Tests for SynapPlugin."""
+
+import pytest
+from unittest.mock import AsyncMock, MagicMock
+
+from synap_semantic_kernel.plugin import SynapPlugin
+
+
+@pytest.fixture
+def mock_sdk():
+    sdk = MagicMock()
+    sdk.fetch = AsyncMock()
+    sdk.memories.create = AsyncMock()
+    return sdk
+
+
+@pytest.fixture
+def plugin(mock_sdk):
+    return SynapPlugin(sdk=mock_sdk, user_id="u1")
+
+
+def test_import():
+    from synap_semantic_kernel import SynapPlugin
+    assert SynapPlugin is not None
+
+
+@pytest.mark.asyncio
+async def test_search_memory(plugin, mock_sdk):
+    mock_sdk.fetch.return_value = MagicMock(formatted_context="likes coffee")
+
+    result = await plugin.search_memory(query="coffee")
+
+    assert result == "likes coffee"
+    mock_sdk.fetch.assert_awaited_once()
+    assert mock_sdk.fetch.call_args.kwargs["search_query"] == ["coffee"]
+
+
+@pytest.mark.asyncio
+async def test_search_memory_no_results(plugin, mock_sdk):
+    mock_sdk.fetch.return_value = MagicMock(formatted_context=None)
+
+    result = await plugin.search_memory(query="nothing")
+    assert result == "No relevant memories found."
+
+
+@pytest.mark.asyncio
+async def test_store_memory(plugin, mock_sdk):
+    mock_sdk.memories.create.return_value = MagicMock(ingestion_id="ing-1")
+
+    result = await plugin.store_memory(content="prefers dark mode")
+
+    assert "ing-1" in result
+    mock_sdk.memories.create.assert_awaited_once()