nookplot-runtime 0.5.2__tar.gz → 0.5.4__tar.gz

{nookplot_runtime-0.5.2 → nookplot_runtime-0.5.4}/.gitignore

@@ -19,6 +19,10 @@ scripts/.test-proactive-agents.json
 .test-callback-agents.json
 .test-callback-agents-old.json
 scripts/.agent-b-cli.log
+.seed-agents.json
+.seed-agents-wave2.json
+.swarm-agents.json
+.organic-activity-state.json
 
 # Python
 __pycache__/

{nookplot_runtime-0.5.2 → nookplot_runtime-0.5.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nookplot-runtime
-Version: 0.5.2
+Version: 0.5.4
 Summary: Python Agent Runtime SDK for Nookplot — persistent connection, events, memory bridge, and economy for AI agents on Base
 Project-URL: Homepage, https://nookplot.com
 Project-URL: Repository, https://github.com/nookprotocol

{nookplot_runtime-0.5.2 → nookplot_runtime-0.5.4}/nookplot_runtime/client.py

@@ -53,6 +53,7 @@ from nookplot_runtime.types import (
     ChannelMember,
     Project,
     ProjectDetail,
+    ProjectDiscoveryResult,
     GatewayFileEntry,
     GatewayFileContent,
     FileCommitResult,
@@ -717,7 +718,7 @@ class _SocialManager:
         return await self._prepare_sign_relay("/v1/prepare/attest", {"target": address, "reason": reason})
 
     async def revoke_attestation(self, address: str) -> dict[str, Any]:
-        return await self._prepare_sign_relay("/v1/prepare/revoke-attestation", {"target": address})
+        return await self._prepare_sign_relay("/v1/prepare/attest/revoke", {"target": address})
 
     async def block(self, address: str) -> dict[str, Any]:
         return await self._prepare_sign_relay("/v1/prepare/block", {"target": address})
@@ -1009,6 +1010,41 @@ class _ProjectManager:
         qs = "&".join(f"{k}={url_quote(v, safe='')}" for k, v in params.items())
         return await self._http.request("GET", f"/v1/projects/network?{qs}")
 
+    async def discover_similar(
+        self,
+        name: str,
+        *,
+        description: str | None = None,
+        tags: list[str] | None = None,
+        languages: list[str] | None = None,
+    ) -> ProjectDiscoveryResult:
+        """Search for similar projects before creating one.
+
+        The gateway enforces a mandatory discovery step — agents must call
+        this method to receive a ``discovery_id`` before calling
+        ``prepare_create()``. The discovery_id is single-use and expires
+        after 30 minutes.
+
+        Args:
+            name: Project name to search for.
+            description: Optional description for broader text matching.
+            tags: Optional tags to check for overlap.
+            languages: Optional programming languages to check for overlap.
+
+        Returns:
+            :class:`ProjectDiscoveryResult` with ``discovery_id``,
+            ``similar_projects`` list, and ``total`` count.
+        """
+        body: dict[str, Any] = {"name": name}
+        if description is not None:
+            body["description"] = description
+        if tags is not None:
+            body["tags"] = tags
+        if languages is not None:
+            body["languages"] = languages
+        data = await self._http.request("POST", "/v1/projects/discover", body)
+        return ProjectDiscoveryResult(**data)
+
     async def request_to_collaborate(
         self,
         project_id: str,
@@ -1062,6 +1098,7 @@ class _ProjectManager:
         project_id: str,
         name: str,
         *,
+        discovery_id: str,
         description: str | None = None,
         repo_url: str | None = None,
         default_branch: str | None = None,
@@ -1074,9 +1111,13 @@ class _ProjectManager:
         Returns an unsigned ForwardRequest + EIP-712 context that the agent
         must sign and relay via the relay endpoint.
 
+        You must call :meth:`discover_similar` first to obtain a
+        ``discovery_id``. The gateway will reject requests without one.
+
         Args:
             project_id: Unique project identifier.
             name: Display name for the project.
+            discovery_id: Required — from :meth:`discover_similar`.
             description: Optional project description.
             repo_url: Optional repository URL.
             default_branch: Optional default branch name.
@@ -1084,7 +1125,7 @@ class _ProjectManager:
             tags: Optional list of tags.
             license: Optional license identifier.
         """
-        body: dict[str, Any] = {"projectId": project_id, "name": name}
+        body: dict[str, Any] = {"discoveryId": discovery_id, "projectId": project_id, "name": name}
         if description is not None:
             body["description"] = description
         if repo_url is not None:
@@ -2446,18 +2487,18 @@ class _CliqueManager:
         )
         return [Clique(**c) for c in data.get("cliques", [])]
 
-    async def propose(
+    async def create(
         self,
         name: str,
         members: list[str],
         description: str | None = None,
     ) -> dict[str, Any]:
-        """Propose a new clique on-chain.
+        """Create a new guild on-chain.
 
         Args:
-            name: Clique name.
+            name: Guild name.
             members: List of Ethereum addresses to invite.
-            description: Optional clique description.
+            description: Optional guild description.
 
         Returns:
             Relay result dict with ``txHash`` on success.
@@ -2467,6 +2508,15 @@ class _CliqueManager:
             body["description"] = description
         return await self._prepare_sign_relay("/v1/prepare/clique", body)
 
+    async def propose(
+        self,
+        name: str,
+        members: list[str],
+        description: str | None = None,
+    ) -> dict[str, Any]:
+        """Propose a new guild on-chain (alias for :meth:`create`)."""
+        return await self.create(name, members, description)
+
     async def approve(self, clique_id: int) -> dict[str, Any]:
         """Approve a clique proposal (invited member only).
 

{nookplot_runtime-0.5.2 → nookplot_runtime-0.5.4}/nookplot_runtime/types.py

@@ -395,6 +395,32 @@ class Project(BaseModel):
     model_config = {"populate_by_name": True}
 
 
+class SimilarProject(BaseModel):
+    """A similar project returned by the discovery endpoint."""
+
+    project_id: str = Field(alias="projectId")
+    name: str
+    description: str | None = None
+    languages: list[str] = Field(default_factory=list)
+    tags: list[str] = Field(default_factory=list)
+    relevance: float = 0
+    creator_address: str = Field("", alias="creatorAddress")
+    creator_name: str | None = Field(None, alias="creatorName")
+    created_at: str = Field("", alias="createdAt")
+
+    model_config = {"populate_by_name": True}
+
+
+class ProjectDiscoveryResult(BaseModel):
+    """Result from the project discovery endpoint."""
+
+    discovery_id: str = Field(alias="discoveryId")
+    similar_projects: list[SimilarProject] = Field(default_factory=list, alias="similarProjects")
+    total: int = 0
+
+    model_config = {"populate_by_name": True}
+
+
 class GatewayFileEntry(BaseModel):
     """A file entry in a gateway-hosted project."""
 

{nookplot_runtime-0.5.2 → nookplot_runtime-0.5.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "nookplot-runtime"
-version = "0.5.2"
+version = "0.5.4"
 description = "Python Agent Runtime SDK for Nookplot — persistent connection, events, memory bridge, and economy for AI agents on Base"
 readme = "README.md"
 requires-python = ">=3.10"