better-notion 1.0.1__py3-none-any.whl → 1.1.0__py3-none-any.whl

better_notion/plugins/official/agents_sdk/plugin.py

@@ -0,0 +1,146 @@
+"""Agents SDK Plugin - Registers workflow models and caches.
+
+This plugin implements the SDKPluginInterface to register workflow
+entity models (Organization, Project, Version, Task) and their
+dedicated caches with NotionClient.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
+from better_notion._sdk.cache import Cache
+from better_notion._sdk.plugins import SDKPluginInterface
+
+if TYPE_CHECKING:
+    from better_notion._sdk.base.entity import BaseEntity
+    from better_notion._sdk.client import NotionClient
+
+
+class AgentsSDKPlugin:
+    """
+    SDK Plugin for agents workflow management system.
+
+    This plugin registers workflow entity models and dedicated caches
+    with NotionClient, enabling agents to work with Organizations,
+    Projects, Versions, and Tasks through the SDK.
+
+    Example:
+        >>> from better_notion import NotionClient
+        >>> from better_notion.plugins.official.agents_sdk import AgentsSDKPlugin
+        >>>
+        >>> client = NotionClient(auth="...")
+        >>> plugin = AgentsSDKPlugin()
+        >>>
+        >>> # Register models and caches
+        >>> client.register_sdk_plugin(plugin)
+        >>>
+        >>> # Now use models
+        >>> org = await Organization.get("org_id", client=client)
+    """
+
+    def register_models(self) -> dict[str, type]:
+        """Register workflow entity models.
+
+        Returns:
+            Dictionary mapping model names to model classes
+        """
+        from better_notion.plugins.official.agents_sdk.models import (
+            Idea,
+            Incident,
+            Organization,
+            Project,
+            Task,
+            Version,
+            WorkIssue,
+        )
+
+        return {
+            "Organization": Organization,
+            "Project": Project,
+            "Version": Version,
+            "Task": Task,
+            "Idea": Idea,
+            "WorkIssue": WorkIssue,
+            "Incident": Incident,
+        }
+
+    def register_caches(self, client: "NotionClient") -> dict[str, Cache]:
+        """Register dedicated caches for workflow entities.
+
+        Args:
+            client: NotionClient instance
+
+        Returns:
+            Dictionary mapping cache names to Cache instances
+        """
+        return {
+            "organizations": Cache(),
+            "projects": Cache(),
+            "versions": Cache(),
+            "tasks": Cache(),
+            "ideas": Cache(),
+            "work_issues": Cache(),
+            "incidents": Cache(),
+        }
+
+    def register_managers(self, client: "NotionClient") -> dict[str, Any]:
+        """Register custom managers for workflow entities.
+
+        Args:
+            client: NotionClient instance
+
+        Returns:
+            Dictionary mapping manager names to manager instances
+        """
+        from better_notion.plugins.official.agents_sdk.managers import (
+            IdeaManager,
+            IncidentManager,
+            OrganizationManager,
+            ProjectManager,
+            TaskManager,
+            VersionManager,
+            WorkIssueManager,
+        )
+
+        return {
+            "organizations": OrganizationManager(client),
+            "projects": ProjectManager(client),
+            "versions": VersionManager(client),
+            "tasks": TaskManager(client),
+            "ideas": IdeaManager(client),
+            "work_issues": WorkIssueManager(client),
+            "incidents": IncidentManager(client),
+        }
+
+    def initialize(self, client: "NotionClient") -> None:
+        """Initialize plugin resources.
+
+        Loads workspace configuration to get database IDs.
+
+        Args:
+            client: NotionClient instance
+        """
+        import json
+        from pathlib import Path
+
+        config_path = Path.home() / ".notion" / "workspace.json"
+
+        if config_path.exists():
+            with open(config_path) as f:
+                client._workspace_config = json.load(f)
+        else:
+            client._workspace_config = {}
+
+    def get_info(self) -> dict[str, Any]:
+        """Return plugin metadata.
+
+        Returns:
+            Dictionary with plugin information
+        """
+        return {
+            "name": "agents-sdk",
+            "version": "1.0.0",
+            "description": "SDK extensions for agents workflow management",
+            "author": "Better Notion Team",
+        }

{better_notion-1.0.1.dist-info → better_notion-1.1.0.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: better-notion
-Version: 1.0.1
-Summary: A high-level Python SDK for the Notion API with developer experience in mind. Now with AI agents workflow management system!
+Version: 1.1.0
+Summary: A high-level Python SDK for the Notion API with developer experience in mind.
 Project-URL: Homepage, https://github.com/nesalia-inc/better-notion
 Project-URL: Documentation, https://github.com/nesalia-inc/better-notion#readme
 Project-URL: Repository, https://github.com/nesalia-inc/better-notion

{better_notion-1.0.1.dist-info → better_notion-1.1.0.dist-info}/RECORD

@@ -50,7 +50,8 @@ better_notion/_cli/commands/users.py,sha256=wpjKCo-HHfpiGsjvLSs8nb2MjZ8nxtppCC0N
 better_notion/_cli/commands/workspace.py,sha256=f3VQcXZ6lu2QrAxkQyFVb3FVU7LYC8kag6VOUvVEu-c,3671
 better_notion/_cli/utils/__init__.py,sha256=VV2SaZnclN-HMMRIsqgxlBNL2HB4n1AvAfMJJWCoTxo,29
 better_notion/_sdk/__init__.py,sha256=oTo9qHSrRBRqPw-2ZHU5TR4erVZTf9IzYRFP8ju9H5U,210
-better_notion/_sdk/client.py,sha256=M4caAOYIfEYomZSAvZZKlPTzukh-6iwAECxr36OcZ7Y,10185
+better_notion/_sdk/client.py,sha256=1XKpMLNesCNi4xq6zi__qgh02SLcB3ZwWM-gG-7PAUQ,13660
+better_notion/_sdk/plugins.py,sha256=G_EU37nnDdYW6_qyw09goteJi5nvwV0F0jZ8-v-OSEA,6090
 better_notion/_sdk/base/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 better_notion/_sdk/base/entity.py,sha256=eAFb_7CTVV6A6L-cfi0RkI5jA1lAa7SUTuruDT1cfEA,8655
 better_notion/_sdk/cache/__init__.py,sha256=JEfrfPWoOTbFv-DhAL-SkPXBlxzuALk4KO1r80iVznU,147
@@ -102,12 +103,17 @@ better_notion/_sdk/query/__init__.py,sha256=1zpOcxwX211AHky1DGA7JDi3eijhEn90zBQL
 better_notion/_sdk/query/database_query.py,sha256=O-fdt7q8C6df9OpZXYVbJPLP6cB7_g0zuGyAOBaNXRY,8979
 better_notion/_sdk/query/filter_translator.py,sha256=Fdsyz5-1OLChi5yzSRPSDUyGspJeK0ME20-EAek0yT4,11204
 better_notion/plugins/__init__.py,sha256=ZbaLy0BS4_zWfEyCW0Xv9EhK427cEhrKIap_8DRvp04,322
-better_notion/plugins/base.py,sha256=G2asUEvQXWIiyWvNtB1hgg9JXZhDayi7Jvfq15FeQWY,5255
-better_notion/plugins/loader.py,sha256=ewCG_Thv7Khh8IsHLB17U1Hi0cWpq0YG3w37hrpbeRk,7710
+better_notion/plugins/base.py,sha256=3h9jOZzS--UqmVW3RREtcQ2h1GTWWPUryTencsJKhTM,8452
+better_notion/plugins/loader.py,sha256=zCWsMdJyvZs1IHFm0zjEiqm_l_5jB1Uw4x30Kq8rLS4,9527
 better_notion/plugins/state.py,sha256=jH_tZWvC35hqLO4qwl2Kwq9ziWVavwCEUcCqy3s5wMY,3780
-better_notion/plugins/official/__init__.py,sha256=rPg5vdk1cEANVstMPzxcWmImtsOpdSR40JSml7h1uUk,426
-better_notion/plugins/official/agents.py,sha256=8Cwx5fkNMaYc1bavS48jyvaXCTMYWgCaIMZH0y9YSbM,12696
+better_notion/plugins/official/__init__.py,sha256=4c0kaPLOqUQ7vIISgCm4Y9TG306Vew5A8dfDrLsAGwc,327
+better_notion/plugins/official/agents.py,sha256=XT8dRaaSs5PSciuA4ne6belQflneS72_L1-GLgDccw0,19308
+better_notion/plugins/official/agents_cli.py,sha256=rFF3cIXXzxOnvd5dnaR1CESvs1mwmR1hBv1lVADcIu8,56317
 better_notion/plugins/official/productivity.py,sha256=_-whP4pYA4HufE1aUFbIdhrjU-O9njI7xUO_Id2M1J8,8726
+better_notion/plugins/official/agents_sdk/__init__.py,sha256=luQBzZLsJ7fC5U0jFu8dfzMviiXj2SBZXcTohM53wkQ,725
+better_notion/plugins/official/agents_sdk/managers.py,sha256=dkpGozJhKXvz8rFqc2tAWyL6MeVzFVcjGMC0Ed2Z1dQ,29813
+better_notion/plugins/official/agents_sdk/models.py,sha256=gwGw9t-Z17NxddzmRKWiD9Noje86sxgPNlLJGARI0KA,75448
+better_notion/plugins/official/agents_sdk/plugin.py,sha256=bs9O8Unv6SARGj4lBU5Gj9HGbLTUNqTacJ3RLUhdbI4,4479
 better_notion/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 better_notion/utils/helpers.py,sha256=HgFuUQlG_HzBOB0z2GA9RxPLoXgwRc0DIxa9Fg6C-Jk,2337
 better_notion/utils/retry.py,sha256=9WJDNitiIfVTL18hIlipvOKn41ukePrOwtAwx-LevpQ,7479
@@ -119,8 +125,8 @@ better_notion/utils/agents/rbac.py,sha256=8ZA8Y7wbOiVZDbpjpH7iC35SZrZ0jl4fcJ3xWC
 better_notion/utils/agents/schemas.py,sha256=e_lpGGO12FXtfqFyI91edj9xc5RUtuA6pU7Sk6ip7xg,21784
 better_notion/utils/agents/state_machine.py,sha256=xUBEeDTbU1Xq-rsRo2sbr6AUYpYrV9DTHOtZT2cWES8,6699
 better_notion/utils/agents/workspace.py,sha256=T8mP_DNIWhI1-k6UydJINsEJ6kQxQ6_Pa44ul58k088,12370
-better_notion-1.0.1.dist-info/METADATA,sha256=twwihoncbT6FKJ_VmFtC_5g2zXSY12q-YAWFm4hLaqQ,11143
-better_notion-1.0.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-better_notion-1.0.1.dist-info/entry_points.txt,sha256=D0bUcP7Z00Zyjxw7r2p29T95UrwioDO0aGDoHe9I6fo,55
-better_notion-1.0.1.dist-info/licenses/LICENSE,sha256=BAdN3JpgMY_y_fWqZSCFSvSbC2mTHP-BKDAzF5FXQAI,1069
-better_notion-1.0.1.dist-info/RECORD,,
+better_notion-1.1.0.dist-info/METADATA,sha256=0DMYo11viAhTUxNMaap6BklxMC0WnkKxxSM8ASsIicE,11096
+better_notion-1.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+better_notion-1.1.0.dist-info/entry_points.txt,sha256=D0bUcP7Z00Zyjxw7r2p29T95UrwioDO0aGDoHe9I6fo,55
+better_notion-1.1.0.dist-info/licenses/LICENSE,sha256=BAdN3JpgMY_y_fWqZSCFSvSbC2mTHP-BKDAzF5FXQAI,1069
+better_notion-1.1.0.dist-info/RECORD,,