dragon-py-a2a 0.1.0__tar.gz

dragon_py_a2a-0.1.0/PKG-INFO

@@ -0,0 +1,14 @@
+Metadata-Version: 2.4
+Name: dragon-py-a2a
+Version: 0.1.0
+Summary: DRAGON A2A 协议客户端（Python）：官方 v1.0 卡面 + ARA 投影 + JSON-RPC 透传
+License: Apache-2.0
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: pydantic>=1.10
+Requires-Dist: dragon-py-core
+
+# dragon-py-a2a
+
+DRAGON 领域框架 Python SDK 组件（a2a 面）。用法与多语言一致性门禁见
+[python/README.md](../README.md)；框架主仓：DRAGON 领域框架（Apache-2.0）。

dragon_py_a2a-0.1.0/README.md

@@ -0,0 +1,4 @@
+# dragon-py-a2a
+
+DRAGON 领域框架 Python SDK 组件（a2a 面）。用法与多语言一致性门禁见
+[python/README.md](../README.md)；框架主仓：DRAGON 领域框架（Apache-2.0）。

dragon_py_a2a-0.1.0/pyproject.toml

@@ -0,0 +1,15 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "dragon-py-a2a"
+version = "0.1.0"
+description = "DRAGON A2A 协议客户端（Python）：官方 v1.0 卡面 + ARA 投影 + JSON-RPC 透传"
+requires-python = ">=3.10"
+license = {text = "Apache-2.0"}
+readme = "README.md"
+dependencies = ["pydantic>=1.10", "dragon-py-core"]
+
+[tool.setuptools.packages.find]
+where = ["src"]

dragon_py_a2a-0.1.0/setup.cfg

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

dragon_py_a2a-0.1.0/src/dragon_py_a2a/__init__.py

@@ -0,0 +1,9 @@
+"""dragon_py_a2a — A2A 协议客户端（官方 v1.0 卡面 + JSON-RPC 透传）。
+
+S-5 卡面发现（`/.well-known/agent-card.json`）的 Python 消费面；`skills[].tags`
+承载 ARA 投影（GADR-019 模式）。JSON-RPC 方法名以对端实现为准——本客户端提供透传，
+不发明方法语义（诚实边界）。
+"""
+from dragon_py_a2a.client import A2AClient, AgentCard, AgentSkill, fetch_card
+
+__all__ = ["A2AClient", "AgentCard", "AgentSkill", "fetch_card"]

dragon_py_a2a-0.1.0/src/dragon_py_a2a/client.py

@@ -0,0 +1,79 @@
+"""A2A 客户端（stdlib urllib——零第三方传输依赖）。"""
+import json
+import urllib.request
+from typing import Any, Dict, List, Optional
+
+from pydantic import BaseModel, Field
+
+AGENT_CARD_PATH = "/.well-known/agent-card.json"
+
+
+class AgentSkill(BaseModel):
+    id: str
+    name: Optional[str] = None
+    description: Optional[str] = None
+    tags: List[str] = Field(default_factory=list)
+
+
+class AgentCard(BaseModel):
+    name: str
+    description: Optional[str] = None
+    version: Optional[str] = None
+    skills: List[AgentSkill] = Field(default_factory=list)
+
+    def ara_projection(self) -> Dict[str, Any]:
+        """S-5/S-10 投影：tags 语法 → 结构化视图（缺失= None，不造默认；confidence 非法→None 不落 0.0）。"""
+        role = scope = autonomy = contract_version = None
+        confidence = None
+        categories: List[str] = []
+        for skill in self.skills:
+            for tag in skill.tags:
+                if tag in {"L1", "L2", "L3", "L4", "L5"}:
+                    role = tag
+                elif tag in {"IS", "IIS"}:
+                    scope = tag
+                elif tag.startswith("autonomy:"):
+                    autonomy = tag.split(":", 1)[1]
+                elif tag.startswith("confidence:"):
+                    raw = tag.split(":", 1)[1]
+                    try:
+                        confidence = float(raw)
+                    except ValueError:
+                        confidence = None  # 非法数值 → None（不落 0.0）
+                elif tag.startswith("x-dragon.contractVersion:"):
+                    contract_version = tag.split(":", 1)[1]
+                else:
+                    categories.append(tag)
+        return {
+            "role": role,
+            "scope": scope,
+            "categories": categories,
+            "autonomy": autonomy,
+            "confidence": confidence,
+            "contractVersion": contract_version,
+        }
+
+
+def fetch_card(base_url: str, timeout: float = 5.0) -> AgentCard:
+    """拉取并解析官方 v1.0 卡面。"""
+    url = base_url.rstrip("/") + AGENT_CARD_PATH
+    with urllib.request.urlopen(url, timeout=timeout) as resp:  # noqa: S310 (调用方传入可信端点)
+        return AgentCard(**json.loads(resp.read().decode("utf-8")))
+
+
+class A2AClient:
+    """A2A JSON-RPC 透传客户端（方法名以对端实现为准）。"""
+
+    def __init__(self, endpoint: str, timeout: float = 30.0):
+        self.endpoint = endpoint.rstrip("/")
+        self.timeout = timeout
+
+    def call(self, method: str, params: Dict[str, Any]) -> Dict[str, Any]:
+        payload = json.dumps(
+            {"jsonrpc": "2.0", "id": 1, "method": method, "params": params}
+        ).encode("utf-8")
+        req = urllib.request.Request(  # noqa: S310
+            self.endpoint, data=payload, headers={"content-type": "application/json"}
+        )
+        with urllib.request.urlopen(req, timeout=self.timeout) as resp:  # noqa: S310
+            return json.loads(resp.read().decode("utf-8"))

dragon_py_a2a-0.1.0/src/dragon_py_a2a.egg-info/PKG-INFO

@@ -0,0 +1,14 @@
+Metadata-Version: 2.4
+Name: dragon-py-a2a
+Version: 0.1.0
+Summary: DRAGON A2A 协议客户端（Python）：官方 v1.0 卡面 + ARA 投影 + JSON-RPC 透传
+License: Apache-2.0
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: pydantic>=1.10
+Requires-Dist: dragon-py-core
+
+# dragon-py-a2a
+
+DRAGON 领域框架 Python SDK 组件（a2a 面）。用法与多语言一致性门禁见
+[python/README.md](../README.md)；框架主仓：DRAGON 领域框架（Apache-2.0）。

dragon_py_a2a-0.1.0/src/dragon_py_a2a.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+src/dragon_py_a2a/__init__.py
+src/dragon_py_a2a/client.py
+src/dragon_py_a2a.egg-info/PKG-INFO
+src/dragon_py_a2a.egg-info/SOURCES.txt
+src/dragon_py_a2a.egg-info/dependency_links.txt
+src/dragon_py_a2a.egg-info/requires.txt
+src/dragon_py_a2a.egg-info/top_level.txt
+tests/test_card.py

dragon_py_a2a-0.1.0/src/dragon_py_a2a.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

dragon_py_a2a-0.1.0/src/dragon_py_a2a.egg-info/requires.txt

@@ -0,0 +1,2 @@
+pydantic>=1.10
+dragon-py-core

dragon_py_a2a-0.1.0/src/dragon_py_a2a.egg-info/top_level.txt

@@ -0,0 +1 @@
+dragon_py_a2a

dragon_py_a2a-0.1.0/tests/test_card.py

@@ -0,0 +1,57 @@
+"""A2A 客户端测试：真卡面形状（取自 2026-09-22 hello-domain 实测记录）+ ARA 投影语义。"""
+from dragon_py_a2a import AgentCard, AgentSkill
+
+# 真实卡面（hello 域实测输出节选——shapes 与官方 v1.0 一致）
+RAW_CARD = {
+    "name": "hello 示例服务",
+    "description": "hello 域示例 IS（脚手架生成——契约正本）",
+    "version": "1.0.0",
+    "supportedInterfaces": [
+        {
+            "protocolBinding": "JSONRPC",
+            "url": "http://127.0.0.1:8907",
+            "tenant": "",
+            "protocolVersion": "1.0",
+        }
+    ],
+    "capabilities": {
+        "streaming": True,
+        "pushNotifications": True,
+        "extendedAgentCard": False,
+        "extensions": [],
+    },
+    "skills": [
+        {
+            "id": "hello.hello",
+            "name": "hello 示例服务",
+            "tags": ["L4", "IS", "autonomy:L1", "confidence:0.8", "x-dragon.contractVersion:1.0.0"],
+        }
+    ],
+}
+
+
+def test_card_parses_official_v1_shape():
+    card = AgentCard(**RAW_CARD)
+    assert card.name == "hello 示例服务"
+    assert card.skills[0].id == "hello.hello"
+
+
+def test_ara_projection_maps_tags_never_defaults():
+    proj = AgentCard(**RAW_CARD).ara_projection()
+    assert proj["role"] == "L4"
+    assert proj["scope"] == "IS"
+    assert proj["autonomy"] == "L1"
+    assert proj["confidence"] == 0.8
+    assert proj["contractVersion"] == "1.0.0"
+
+
+def test_missing_tags_project_to_none_not_default():
+    card = AgentCard(name="bare", skills=[AgentSkill(id="x")])
+    proj = card.ara_projection()
+    assert proj["role"] is None and proj["scope"] is None
+    assert proj["autonomy"] is None and proj["contractVersion"] is None
+
+
+def test_invalid_confidence_degrades_to_none_never_zero():
+    card = AgentCard(name="bad", skills=[AgentSkill(id="x", tags=["confidence:NaN?"])])
+    assert card.ara_projection()["confidence"] is None