agentnexus-sdk 0.8.0__tar.gz

agentnexus_sdk-0.8.0/.gitignore

@@ -0,0 +1,37 @@
+# --- Python 基础 ---
+__pycache__/
+*.py[cod]
+*$py.class
+.pytest_cache/
+.venv/
+venv/
+env/
+build/
+dist/
+
+# --- 操作系统与 IDE ---
+.DS_Store
+.idea/
+.vscode/
+*.swp
+
+# --- AgentNexus 运行时数据 ---
+data/                            # 运行时生成：DB、token、白/黑名单、配置
+
+# --- AgentNexus 核心安全 (非常重要！) ---
+# 绝不要上传任何包含私钥的文件
+*.key
+*.pem
+identity/*.json
+!identity/profile.example.json  # 允许上传示例模板
+*.db                             # 排除本地 SQLite 数据库
+*.log                            # 排除运行日志
+
+# --- AI 助手上下文 ---
+claude.md
+trae.md
+.claudecode/
+
+# --- 配置文件 ---
+.env
+config.local.yaml

agentnexus_sdk-0.8.0/PKG-INFO

@@ -0,0 +1,22 @@
+Metadata-Version: 2.4
+Name: agentnexus-sdk
+Version: 0.8.0
+Summary: AgentNexus Python SDK - 3 lines to connect your AI Agent to the decentralized network
+Project-URL: Homepage, https://github.com/anthropics/agentnexus
+Project-URL: Documentation, https://github.com/anthropics/agentnexus#readme
+Author: AgentNexus Team
+License-Expression: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'

agentnexus_sdk-0.8.0/examples/discussion_demo.py

@@ -0,0 +1,86 @@
+"""
+Example: Multi-Agent Discussion Demo
+
+Demonstrates how to start a discussion, vote, and conclude.
+"""
+import asyncio
+import agentnexus
+from agentnexus import (
+    Consensus,
+    ConsensusMode,
+    TimeoutAction,
+    ActionItem,
+    ConclusionType,
+    DiscussionManager,
+)
+
+
+async def main():
+    # Connect to AgentNexus network
+    nexus = await agentnexus.connect(
+        name="DiscussionLeader",
+        caps=["Chat", "Discussion"],
+    )
+
+    print(f"Connected as: {nexus.agent_info.did}")
+
+    # Create discussion manager
+    discussion_mgr = DiscussionManager(nexus)
+
+    # Start a discussion with majority voting
+    topic_id = await discussion_mgr.start_discussion(
+        title="Should we use async or sync API?",
+        participants=[
+            "did:agentnexus:z6Mk...dev1",  # Replace with actual DIDs
+            "did:agentnexus:z6Mk...dev2",
+        ],
+        context="We need to decide on the API style for the SDK.",
+        consensus=Consensus(
+            mode=ConsensusMode.MAJORITY,
+            timeout_seconds=300,  # 5 minutes
+            timeout_action=TimeoutAction.AUTO_REJECT,
+        ),
+        related_task_id="task_sdk_design",
+    )
+
+    print(f"Started discussion: {topic_id}")
+
+    # Simulate discussion flow
+    await asyncio.sleep(2)
+
+    # Reply to discussion
+    await discussion_mgr.reply(
+        topic_id=topic_id,
+        content="I prefer async API because it's more flexible.",
+    )
+
+    # Cast vote
+    await discussion_mgr.vote(
+        topic_id=topic_id,
+        vote="approve",
+        reason="Async is the way to go",
+    )
+
+    # After voting completes (simulated), conclude
+    await asyncio.sleep(2)
+
+    await discussion_mgr.conclude(
+        topic_id=topic_id,
+        conclusion="We will use async API with sync wrapper as optional",
+        conclusion_type=ConclusionType.CONSENSUS,
+        action_items=[
+            ActionItem(
+                type="update_document",
+                ref="adr-006",
+                description="Update SDK architecture doc with async-first approach",
+            ),
+        ],
+    )
+
+    print("Discussion concluded!")
+
+    await nexus.close()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

agentnexus_sdk-0.8.0/examples/echo_bot.py

@@ -0,0 +1,71 @@
+"""
+Example: Echo Bot with Discussion Protocol
+
+A simple bot that echoes messages and demonstrates discussion capabilities.
+"""
+import asyncio
+import agentnexus
+from agentnexus import (
+    Consensus,
+    ConsensusMode,
+    TimeoutAction,
+    ActionItem,
+    ConclusionType,
+)
+
+
+async def main():
+    # Connect to AgentNexus network
+    nexus = await agentnexus.connect(
+        name="EchoBot",
+        caps=["Chat", "Discussion"],
+    )
+
+    print(f"Connected as: {nexus.agent_info.did}")
+
+    # Message handler
+    @nexus.on_message
+    async def handle_message(msg):
+        print(f"[MSG] From {msg.from_did}: {msg.content}")
+
+        # Echo back
+        await nexus.send(
+            to_did=msg.from_did,
+            content=f"Echo: {msg.content}",
+        )
+
+    # Task proposal handler
+    @nexus.on_task_propose
+    async def handle_task_propose(action):
+        print(f"[TASK] New task: {action.content['title']}")
+
+        # Claim the task
+        await nexus.claim_task(
+            to_did=action.from_did,
+            task_id=action.content["task_id"],
+            message="I'll handle this!",
+        )
+
+        # Simulate work
+        await asyncio.sleep(1)
+
+        # Notify completion
+        await nexus.notify_state(
+            to_did=action.from_did,
+            status="completed",
+            task_id=action.content["task_id"],
+        )
+
+    # Keep running
+    print("EchoBot is running. Press Ctrl+C to stop.")
+    try:
+        while True:
+            await asyncio.sleep(1)
+    except KeyboardInterrupt:
+        pass
+    finally:
+        await nexus.close()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

agentnexus_sdk-0.8.0/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "agentnexus-sdk"
+version = "0.8.0"
+description = "AgentNexus Python SDK - 3 lines to connect your AI Agent to the decentralized network"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "AgentNexus Team" }
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+    "aiohttp>=3.9.0",
+    "pydantic>=2.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.23.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/anthropics/agentnexus"
+Documentation = "https://github.com/anthropics/agentnexus#readme"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/agentnexus"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"

agentnexus_sdk-0.8.0/skill.yaml

@@ -0,0 +1,109 @@
+# AgentNexus Skill
+#
+# 标准化能力描述文件，供 AI Agent 框架自动发现和安装 AgentNexus 通信能力。
+# 兼容 OpenClaw Skill 规范。
+
+name: agentnexus
+version: 0.1.0
+description: "给你的 AI Agent 接入去中心化通信网络 — DID 身份、加密消息、联邦发现、协作协议"
+description_en: "Connect your AI Agent to a decentralized communication network — DID identity, encrypted messaging, federated discovery, collaboration protocol"
+
+author: AgentNexus Team
+license: Apache-2.0
+homepage: https://github.com/kevinkaylie/AgentNexus
+repository: https://github.com/kevinkaylie/AgentNexus
+
+# 运行要求
+requirements:
+  python: ">=3.10"
+  packages:
+    - agentnexus-sdk>=0.1.0
+  services:
+    - name: agentnexus-daemon
+      description: "AgentNexus Node Daemon（本地通信节点）"
+      start_command: "python main.py node start"
+      health_check: "http://localhost:8765/health"
+
+# Skill 提供的能力
+capabilities:
+  - id: messaging
+    name: "Agent 消息收发"
+    description: "向任意 DID 地址发送加密消息，接收离线消息"
+    actions:
+      - send_message
+      - receive_message
+
+  - id: discovery
+    name: "Agent 发现"
+    description: "按能力关键词搜索其他 Agent，联邦 Relay 跨网查找"
+    actions:
+      - search_agents
+
+  - id: collaboration
+    name: "协作协议"
+    description: "四种基础协作动作：任务发布/认领/资源同步/状态汇报"
+    actions:
+      - propose_task
+      - claim_task
+      - sync_resource
+      - notify_state
+
+  - id: trust
+    name: "信任验证"
+    description: "L1-L4 信任等级验证，CA 认证签发与查询"
+    actions:
+      - verify_agent
+      - certify_agent
+
+# 快速接入（Agent 框架读取此段自动初始化）
+quickstart:
+  async: |
+    import agentnexus
+
+    nexus = await agentnexus.connect("${AGENT_NAME}", caps=${AGENT_CAPS})
+
+    # 发消息
+    await nexus.send(to_did="${TARGET_DID}", content="Hello from ${AGENT_NAME}!")
+
+    # 收消息
+    @nexus.on_message
+    async def handle(msg):
+        print(f"From {msg.from_did}: {msg.content}")
+
+    # 协作
+    task_id = await nexus.propose_task(to_did="${TARGET_DID}", title="协作任务")
+
+  sync: |
+    import agentnexus.sync
+
+    nexus = agentnexus.sync.connect("${AGENT_NAME}", caps=${AGENT_CAPS})
+    nexus.send(to_did="${TARGET_DID}", content="Hello!")
+    nexus.close()
+
+# 变量说明（框架在安装时提示用户填写或自动推断）
+variables:
+  AGENT_NAME:
+    description: "Agent 名称"
+    required: true
+    example: "MyAssistant"
+  AGENT_CAPS:
+    description: "Agent 能力列表"
+    required: false
+    default: '["Chat"]'
+    example: '["Chat", "Search", "Translation"]'
+  TARGET_DID:
+    description: "目标 Agent 的 DID 地址"
+    required: false
+    example: "did:agentnexus:z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK"
+
+# MCP 集成（已有 MCP Server 的 Agent 可直接用 MCP 工具）
+mcp:
+  enabled: true
+  config:
+    command: "python"
+    args: ["main.py", "node", "mcp", "--name", "${AGENT_NAME}", "--caps", "${AGENT_CAPS}"]
+  tools_count: 15
+  compatible_clients:
+    - Claude Desktop
+    - Cursor
+    - Claude Code

agentnexus_sdk-0.8.0/src/agentnexus/__init__.py

@@ -0,0 +1,102 @@
+"""
+AgentNexus Python SDK
+
+3 lines to connect your AI Agent to the decentralized network.
+
+Usage:
+    import agentnexus
+
+    # Register new identity
+    nexus = await agentnexus.connect("MyAgent", caps=["Chat", "Search"])
+
+    # Or use existing identity
+    nexus = await agentnexus.connect(did="did:agentnexus:z6Mk...")
+
+    # Send message
+    await nexus.send(to_did="did:agentnexus:z6Mk...", content="Hello!")
+
+    # Receive messages
+    @nexus.on_message
+    async def handle(msg):
+        print(f"From {msg.from_did}: {msg.content}")
+
+    # Close connection
+    await nexus.close()
+"""
+
+from .client import AgentNexusClient, connect
+from .exceptions import (
+    AgentNexusError,
+    DaemonNotFoundError,
+    AuthenticationError,
+    AgentNotFoundError,
+    MessageDeliveryError,
+    InvalidActionError,
+    DIDNotFoundError,
+)
+from .models import Message, VerificationResult, Certification
+from .actions import (
+    TaskPropose,
+    TaskClaim,
+    ResourceSync,
+    StateNotify,
+)
+from .discussion import (
+    DiscussionStart,
+    DiscussionReply,
+    DiscussionVote,
+    DiscussionConclude,
+    Consensus,
+    ActionItem,
+    ConsensusMode,
+    TimeoutAction,
+    ConclusionType,
+    DiscussionStateMachine,
+    DiscussionManager,
+)
+from .emergency import (
+    EmergencyConfig,
+    EmergencyController,
+    create_emergency_controller,
+)
+
+__all__ = [
+    # Core
+    "connect",
+    "AgentNexusClient",
+    # Exceptions
+    "AgentNexusError",
+    "DaemonNotFoundError",
+    "AuthenticationError",
+    "AgentNotFoundError",
+    "MessageDeliveryError",
+    "InvalidActionError",
+    "DIDNotFoundError",
+    # Models
+    "Message",
+    "VerificationResult",
+    "Certification",
+    # Actions
+    "TaskPropose",
+    "TaskClaim",
+    "ResourceSync",
+    "StateNotify",
+    # Discussion
+    "DiscussionStart",
+    "DiscussionReply",
+    "DiscussionVote",
+    "DiscussionConclude",
+    "Consensus",
+    "ActionItem",
+    "ConsensusMode",
+    "TimeoutAction",
+    "ConclusionType",
+    "DiscussionStateMachine",
+    "DiscussionManager",
+    # Emergency
+    "EmergencyConfig",
+    "EmergencyController",
+    "create_emergency_controller",
+]
+
+__version__ = "0.1.0"