agentnode-sdk 0.1.0__tar.gz → 0.2.0__tar.gz

agentnode_sdk-0.2.0/.env.example

@@ -0,0 +1,8 @@
+# AgentNode SDK — Environment Variables (optional)
+# These can be passed to AgentNode() constructor instead.
+
+# API endpoint
+AGENTNODE_API_URL=https://api.agentnode.net
+
+# API key
+AGENTNODE_API_KEY=ank_your-api-key-here

{agentnode_sdk-0.1.0 → agentnode_sdk-0.2.0}/.gitignore

@@ -15,10 +15,11 @@ cli/dist/
 web/.next/
 web/out/
 
-# Environment
+# Environment & Secrets
 .env
 .env.local
 .env.production
+.pypirc
 
 # IDE
 .idea/
@@ -42,5 +43,25 @@ htmlcov/
 # Spec documents
 *.docx
 
+# Screenshots & temp files
+*.png
+screenshots/
+test-screenshots/
+spec_extracted.txt
+calendar.ics
+events.json
+
+# Playwright
+.playwright-mcp/
+
 # Claude Code
 .claude/
+
+# Internal growth / marketing content
+growth/
+backend/.next/
+kwfinder-*.md
+packages_dump.json
+snapshot_nonowner.txt
+seo/
+backend/scripts/enrichment_*.json

agentnode_sdk-0.2.0/PKG-INFO

@@ -0,0 +1,93 @@
+Metadata-Version: 2.4
+Name: agentnode-sdk
+Version: 0.2.0
+Summary: Python SDK for AgentNode — the open upgrade and discovery infrastructure for AI agents.
+Project-URL: Homepage, https://agentnode.net
+Project-URL: Repository, https://github.com/agentnode-ai/agentnode
+Project-URL: Documentation, https://agentnode.net/docs
+License-Expression: MIT
+Keywords: agent,agentnode,ai,capabilities,langchain,mcp
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.25
+Provides-Extra: dev
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-asyncio; extra == 'dev'
+Requires-Dist: respx; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# agentnode-sdk
+
+Python SDK for [AgentNode](https://agentnode.net) — the open upgrade and discovery infrastructure for AI agents.
+
+## Installation
+
+```bash
+pip install agentnode-sdk
+```
+
+## Quick Start
+
+```python
+from agentnode_sdk import AgentNodeClient
+from agentnode_sdk.installer import load_tool
+
+client = AgentNodeClient(api_key="ank_...")
+
+# Search for packages
+results = client.search("pdf extraction")
+for hit in results.hits:
+    print(f"{hit.slug} — {hit.summary}")
+
+# Resolve capability gaps
+resolved = client.resolve(
+    capabilities=["pdf_extraction"],
+    framework="langchain",
+)
+
+# v0.2: Load specific tools from multi-tool packs
+describe = load_tool("csv-analyzer-pack", tool_name="describe")
+result = describe({"file_path": "data.csv"})
+
+# Single-tool packs — no tool_name needed
+extract = load_tool("pdf-reader-pack")
+pdf = extract({"file_path": "report.pdf"})
+```
+
+## API Reference
+
+### `AgentNodeClient`
+
+The main client with typed return models.
+
+| Method | Description |
+|--------|-------------|
+| `search(query, ...)` | Search packages by keyword or capability |
+| `resolve(capabilities, ...)` | Resolve capability gaps to ranked packages |
+| `get_package(slug)` | Get package details |
+| `get_install_metadata(slug)` | Get install info (artifact, permissions, deps) |
+| `download(slug)` | Track download and get artifact URL |
+| `load_tool(slug, tool_name=)` | Load a tool function from an installed pack (v0.2) |
+
+### `AgentNode`
+
+Lightweight client returning raw dicts.
+
+| Method | Description |
+|--------|-------------|
+| `search(query, ...)` | Search packages |
+| `resolve_upgrade(missing_capability, ...)` | Resolve a single capability gap |
+| `check_policy(package_slug, ...)` | Evaluate security policy |
+| `get_install_metadata(slug)` | Get install metadata |
+| `install(slug)` | Create installation record |
+| `recommend(missing_capabilities)` | Get recommendations |
+| `validate(manifest)` | Validate a package manifest |
+
+## License
+
+MIT

agentnode_sdk-0.2.0/README.md

@@ -0,0 +1,70 @@
+# agentnode-sdk
+
+Python SDK for [AgentNode](https://agentnode.net) — the open upgrade and discovery infrastructure for AI agents.
+
+## Installation
+
+```bash
+pip install agentnode-sdk
+```
+
+## Quick Start
+
+```python
+from agentnode_sdk import AgentNodeClient
+from agentnode_sdk.installer import load_tool
+
+client = AgentNodeClient(api_key="ank_...")
+
+# Search for packages
+results = client.search("pdf extraction")
+for hit in results.hits:
+    print(f"{hit.slug} — {hit.summary}")
+
+# Resolve capability gaps
+resolved = client.resolve(
+    capabilities=["pdf_extraction"],
+    framework="langchain",
+)
+
+# v0.2: Load specific tools from multi-tool packs
+describe = load_tool("csv-analyzer-pack", tool_name="describe")
+result = describe({"file_path": "data.csv"})
+
+# Single-tool packs — no tool_name needed
+extract = load_tool("pdf-reader-pack")
+pdf = extract({"file_path": "report.pdf"})
+```
+
+## API Reference
+
+### `AgentNodeClient`
+
+The main client with typed return models.
+
+| Method | Description |
+|--------|-------------|
+| `search(query, ...)` | Search packages by keyword or capability |
+| `resolve(capabilities, ...)` | Resolve capability gaps to ranked packages |
+| `get_package(slug)` | Get package details |
+| `get_install_metadata(slug)` | Get install info (artifact, permissions, deps) |
+| `download(slug)` | Track download and get artifact URL |
+| `load_tool(slug, tool_name=)` | Load a tool function from an installed pack (v0.2) |
+
+### `AgentNode`
+
+Lightweight client returning raw dicts.
+
+| Method | Description |
+|--------|-------------|
+| `search(query, ...)` | Search packages |
+| `resolve_upgrade(missing_capability, ...)` | Resolve a single capability gap |
+| `check_policy(package_slug, ...)` | Evaluate security policy |
+| `get_install_metadata(slug)` | Get install metadata |
+| `install(slug)` | Create installation record |
+| `recommend(missing_capabilities)` | Get recommendations |
+| `validate(manifest)` | Validate a package manifest |
+
+## License
+
+MIT

agentnode_sdk-0.2.0/agentnode.lock

@@ -0,0 +1,23 @@
+{
+  "lockfile_version": "0.1",
+  "updated_at": "2026-03-18T02:18:53.827839+00:00",
+  "packages": {
+    "word-counter-pack": {
+      "version": "1.0.0",
+      "package_type": "toolpack",
+      "entrypoint": "word_counter_pack.tool",
+      "capability_ids": [
+        "data_cleaning"
+      ],
+      "tools": [
+        {
+          "name": "count_words",
+          "entrypoint": "word_counter_pack.tool:count_words"
+        }
+      ],
+      "artifact_hash": "sha256:445388c86aa2b20c3e748f58b2d221548f1f3f71ff5c715a64cdc80966fab03c",
+      "installed_at": "2026-03-18T02:18:53.827396+00:00",
+      "source": "sdk"
+    }
+  }
+}

{agentnode_sdk-0.1.0 → agentnode_sdk-0.2.0}/agentnode_sdk/__init__.py

@@ -1,14 +1,20 @@
 """AgentNode Python SDK — discover, resolve, and install AI agent capabilities."""
 
+from agentnode_sdk.async_client import AsyncAgentNode
 from agentnode_sdk.client import AgentNode, AgentNodeClient
 from agentnode_sdk.exceptions import (
     AgentNodeError,
+    AgentNodeToolError,
     AuthError,
     NotFoundError,
+    RateLimitError,
     ValidationError,
 )
+from agentnode_sdk.installer import load_tool
 from agentnode_sdk.models import (
+    CanInstallResult,
     InstallMetadata,
+    InstallResult,
     PackageDetail,
     ResolvedPackage,
     ResolveResult,
@@ -16,13 +22,23 @@ from agentnode_sdk.models import (
     SearchResult,
 )
 
-__version__ = "0.1.0"
+# Convenience aliases
+Client = AgentNodeClient
+ToolError = AgentNodeToolError
+
+__version__ = "0.2.0"
 __all__ = [
     "AgentNode",
+    "AsyncAgentNode",
     "AgentNodeClient",
+    "Client",
+    "load_tool",
     "AgentNodeError",
+    "AgentNodeToolError",
+    "ToolError",
     "NotFoundError",
     "AuthError",
+    "RateLimitError",
     "ValidationError",
     "PackageDetail",
     "SearchResult",
@@ -30,4 +46,6 @@ __all__ = [
     "ResolveResult",
     "ResolvedPackage",
     "InstallMetadata",
+    "InstallResult",
+    "CanInstallResult",
 ]

agentnode_sdk-0.2.0/agentnode_sdk/async_client.py

@@ -0,0 +1,139 @@
+"""Async AgentNode API client. Mirrors AgentNode (sync) using httpx.AsyncClient."""
+from __future__ import annotations
+
+import httpx
+
+from agentnode_sdk.client import DEFAULT_BASE_URL, ERROR_CLASS_MAP
+from agentnode_sdk.exceptions import AgentNodeError
+
+
+class AsyncAgentNode:
+    """Async variant of the AgentNode SDK client. Returns plain dicts."""
+
+    def __init__(self, api_key: str, base_url: str = DEFAULT_BASE_URL):
+        self._client = httpx.AsyncClient(
+            base_url=base_url.rstrip("/"),
+            headers={"X-API-Key": api_key},
+            timeout=30,
+        )
+
+    async def close(self):
+        await self._client.aclose()
+
+    async def __aenter__(self):
+        return self
+
+    async def __aexit__(self, *args):
+        await self.close()
+
+    # --- Public API ---
+
+    async def search(
+        self,
+        query: str = "",
+        capability_id: str = "",
+        framework: str = "",
+        sort_by: str = "relevance",
+        page: int = 1,
+    ) -> dict:
+        body = {k: v for k, v in {
+            "q": query,
+            "capability_id": capability_id,
+            "framework": framework,
+            "sort_by": sort_by,
+            "page": page,
+        }.items() if v}
+        return self._handle(await self._client.post("/search", json=body))
+
+    async def resolve_upgrade(
+        self,
+        missing_capability: str,
+        framework: str = "",
+        runtime: str = "",
+        current_capabilities: list[str] | None = None,
+        policy: dict | None = None,
+    ) -> dict:
+        return await self._post(
+            "/resolve-upgrade",
+            missing_capability=missing_capability,
+            current_capabilities=current_capabilities or [],
+            framework=framework,
+            runtime=runtime,
+            policy=policy or {},
+        )
+
+    async def check_policy(
+        self,
+        package_slug: str,
+        framework: str = "",
+        policy: dict | None = None,
+    ) -> dict:
+        return await self._post(
+            "/check-policy",
+            package_slug=package_slug,
+            framework=framework,
+            policy=policy or {},
+        )
+
+    async def get_install_metadata(self, package_slug: str, version: str = "") -> dict:
+        """Read-only install metadata. Does NOT create installation records."""
+        params = {"version": version} if version else {}
+        return self._handle(
+            await self._client.get(f"/packages/{package_slug}/install-info", params=params)
+        )
+
+    async def get_package(self, slug: str) -> dict:
+        return self._handle(await self._client.get(f"/packages/{slug}"))
+
+    async def validate(self, manifest: dict) -> dict:
+        return self._handle(
+            await self._client.post("/packages/validate", json={"manifest": manifest})
+        )
+
+    async def install(
+        self,
+        package_slug: str,
+        version: str = "",
+        source: str = "sdk",
+        event_type: str = "install",
+    ) -> dict:
+        """Create installation record and get artifact URL."""
+        body: dict = {"source": source, "event_type": event_type}
+        if version:
+            body["version"] = version
+        return self._handle(
+            await self._client.post(f"/packages/{package_slug}/install", json=body)
+        )
+
+    async def recommend(
+        self,
+        missing_capabilities: list[str],
+        framework: str = "",
+        runtime: str = "",
+    ) -> dict:
+        return await self._post(
+            "/recommend",
+            missing_capabilities=missing_capabilities,
+            framework=framework,
+            runtime=runtime,
+        )
+
+    # --- Internal ---
+
+    async def _post(self, path: str, **kwargs) -> dict:
+        body = {k: v for k, v in kwargs.items() if v is not None and v != ""}
+        return self._handle(await self._client.post(path, json=body))
+
+    def _handle(self, response: httpx.Response) -> dict:
+        """Parse response. Raise typed AgentNodeError on API errors."""
+        if response.status_code >= 400:
+            try:
+                body = response.json()
+                err = body.get("error", {})
+                code = err.get("code", "UNKNOWN")
+                message = err.get("message", response.text)
+            except (ValueError, KeyError):
+                code, message = "UNKNOWN", response.text
+            exc_class = ERROR_CLASS_MAP.get(response.status_code, AgentNodeError)
+            raise exc_class(code, message)
+        return response.json()