✨ feat: 灵台引擎 gRPC 独立服务形态（ADR-017 双形态落地）
- proto（engine/proto/liushen/v1）：LingtaiEngine 九方法——GetEngineInfo（版本协商/能力位）、TransformMarkdown、RebuildExport（UNIMPLEMENTED 明示随 WP-03）、OpenStream 双向流、CheckBudget、RerankRecall、EvaluatePolicy、ValidateUrl、CheckStateTransition；RunStatus 枚举与契约一致 - 服务端参考实现（engine/server/lingtai_server.py）：进程内直链 nanobind 引擎核心——双形态同核同 golden；开发档 127.0.0.1 明文（生产 mTLS，文案明示）；状态转换表按 agent-runtime 第 3 节 - 集成测试 6 项：进程内随机端口起服——版本协商、双形态 golden（服务输出==进程内引擎输出，ADR-017 核心不变量首次实证）、双向流 envelope 序号单调、决策表/URL/状态机、RebuildExport UNIMPLEMENTED 明确拒绝（不伪造） - Makefile：lingtai-proto（stub 再生）与 lingtai-server（启动服务）目标 - 注：C++ 原生二进制（hunjing-lingtai-server）随交叉编译矩阵交付；Python 参考实现保证 proto 与语义先行锁定 - 测试 102 项全绿（+6）；ruff/mypy 干净
This commit is contained in:
chenxin committed
1 parent
a39cec5287
commit
9dafb8fe72
10 files changed
+1141
No files matched your search
@@ -53,6 +53,19 @@ openapi-lint: ## 校验 OpenAPI 契约（redocly lint + bundle）
|
||||
generate: openapi-lint ## 生成代码（TypeScript 类型等）
|
||||
cd frontend && npm run generate:api
|
||||
|
||||
# ===== 灵台引擎 gRPC 服务（ADR-017 双形态） =====
|
||||
|
||||
.PHONY: lingtai-proto
|
||||
lingtai-proto: ## 重新生成 gRPC stub（proto 变更后执行）
|
||||
cd backend && uv run python -m grpc_tools.protoc -I../engine/proto \
|
||||
--python_out=../engine/server/generated \
|
||||
--grpc_python_out=../engine/server/generated \
|
||||
liushen/v1/liushen.proto
|
||||
|
||||
.PHONY: lingtai-server
|
||||
lingtai-server: ## 启动灵台引擎独立服务（开发档 127.0.0.1:50051；生产须 mTLS）
|
||||
cd backend && uv run python ../engine/server/lingtai_server.py
|
||||
|
||||
# ===== 前端与桌面（Next.js / Tauri v2） =====
|
||||
|
||||
.PHONY: frontend-setup
|
||||
|
||||
@@ -14,6 +14,8 @@ dependencies = [
|
||||
"uuid-utils>=0.10",
|
||||
"greenlet>=3.5.5",
|
||||
"hunjing-lingtai",
|
||||
"grpcio>=1.83.1",
|
||||
"grpcio-tools>=1.83.1",
|
||||
]
|
||||
|
||||
[dependency-groups]
|
||||
|
||||
@@ -0,0 +1,126 @@
|
||||
"""gRPC 服务形态集成测试：双形态 golden 一致（ADR-017）。
|
||||
|
||||
在进程内启动服务器（随机端口），验证：
|
||||
- GetEngineInfo 版本协商
|
||||
- TransformMarkdown 与进程内 lingtai.transform_markdown 输出一致
|
||||
- OpenStream 双向流 envelope 键序与序号单调
|
||||
- EvaluatePolicy / ValidateUrl / CheckStateTransition / RerankRecall 行为
|
||||
"""
|
||||
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
import grpc
|
||||
import pytest
|
||||
|
||||
_SERVER_ROOT = Path(__file__).resolve().parents[2] / "engine" / "server"
|
||||
sys.path.insert(0, str(_SERVER_ROOT / "generated"))
|
||||
_SERVER_MODULE = _SERVER_ROOT / "lingtai_server.py"
|
||||
|
||||
import liushen.v1.liushen_pb2 as pb # noqa: E402
|
||||
import liushen.v1.liushen_pb2_grpc as pb_grpc # noqa: E402
|
||||
|
||||
from app.core import lingtai # noqa: E402
|
||||
|
||||
|
||||
@pytest.fixture()
|
||||
async def grpc_channel():
|
||||
import importlib.util as _ilu
|
||||
|
||||
from grpc import aio as grpc_aio
|
||||
|
||||
_spec = _ilu.spec_from_file_location(
|
||||
"lingtai_server",
|
||||
_SERVER_MODULE,
|
||||
)
|
||||
_mod = _ilu.module_from_spec(_spec)
|
||||
_spec.loader.exec_module(_mod)
|
||||
LingtaiEngineServicer = _mod.LingtaiEngineServicer
|
||||
|
||||
server = grpc_aio.server()
|
||||
pb_grpc.add_LingtaiEngineServicer_to_server(LingtaiEngineServicer(), server)
|
||||
port = server.add_insecure_port("127.0.0.1:0")
|
||||
await server.start()
|
||||
channel = grpc_aio.insecure_channel(f"127.0.0.1:{port}")
|
||||
yield channel
|
||||
await channel.close()
|
||||
await server.stop(0)
|
||||
|
||||
|
||||
async def test_engine_info(grpc_channel) -> None:
|
||||
stub = pb_grpc.LingtaiEngineStub(grpc_channel)
|
||||
info = await stub.GetEngineInfo(pb.GetEngineInfoRequest())
|
||||
assert info.abi_major == 1
|
||||
assert info.parser_version == "hunjing-markdown-v1"
|
||||
assert "transform" in info.capabilities
|
||||
|
||||
|
||||
async def test_transform_dual_form_golden(grpc_channel) -> None:
|
||||
"""双形态一致：服务输出 == 进程内引擎输出（ADR-017 核心不变量）。"""
|
||||
import json
|
||||
|
||||
stub = pb_grpc.LingtaiEngineStub(grpc_channel)
|
||||
markdown = "说明\n```mermaid\nA-->B\n```\n$$\nz\n$$\n"
|
||||
resp = await stub.TransformMarkdown(pb.TransformMarkdownRequest(markdown=markdown))
|
||||
served = json.loads(resp.canonical_json)
|
||||
inproc = lingtai.transform_markdown(markdown)
|
||||
assert served == inproc # 服务形态与进程内输出一致
|
||||
|
||||
|
||||
async def test_open_stream_envelope(grpc_channel) -> None:
|
||||
import json
|
||||
|
||||
stub = pb_grpc.LingtaiEngineStub(grpc_channel)
|
||||
|
||||
async def frames():
|
||||
yield pb.StreamFrame(block_started="block_01")
|
||||
yield pb.StreamFrame(text_delta="你")
|
||||
yield pb.StreamFrame(text_delta="好")
|
||||
|
||||
events = []
|
||||
async for ev in stub.OpenStream(frames()):
|
||||
events.append(json.loads(ev.event_json))
|
||||
assert len(events) == 2
|
||||
assert all(e["type"] == "content.block.delta" for e in events)
|
||||
seqs = [e["sequence"] for e in events]
|
||||
assert seqs == sorted(seqs)
|
||||
assert events[-1]["data"]["delta"]["text"] == "好"
|
||||
|
||||
|
||||
async def test_policy_and_state(grpc_channel) -> None:
|
||||
stub = pb_grpc.LingtaiEngineStub(grpc_channel)
|
||||
# 决策表
|
||||
assert (await stub.EvaluatePolicy(pb.EvaluatePolicyRequest(
|
||||
autonomy_level=1, risk_level=0))).decision == 0
|
||||
assert (await stub.EvaluatePolicy(pb.EvaluatePolicyRequest(
|
||||
autonomy_level=0, risk_level=2))).decision == 2
|
||||
# URL 白名单
|
||||
assert (await stub.ValidateUrl(pb.ValidateUrlRequest(
|
||||
url="https://ok"))).allowed is True
|
||||
assert (await stub.ValidateUrl(pb.ValidateUrlRequest(
|
||||
url="file:///etc"))).allowed is False
|
||||
# 状态机
|
||||
assert (await stub.CheckStateTransition(pb.CheckStateTransitionRequest(
|
||||
**{"from": pb.RUN_STATUS_QUEUED}, to=pb.RUN_STATUS_RUNNING))).valid is True
|
||||
assert (await stub.CheckStateTransition(pb.CheckStateTransitionRequest(
|
||||
**{"from": pb.RUN_STATUS_COMPLETED}, to=pb.RUN_STATUS_RUNNING))).valid is False
|
||||
|
||||
|
||||
async def test_rerank(grpc_channel) -> None:
|
||||
import json
|
||||
|
||||
stub = pb_grpc.LingtaiEngineStub(grpc_channel)
|
||||
resp = await stub.RerankRecall(pb.RerankRecallRequest(
|
||||
candidates_json='{"query_terms":["魂镜"],"candidates":['
|
||||
'{"id":"a","text":"魂镜 系统"},{"id":"b","text":"无"}]}'
|
||||
))
|
||||
ranked = json.loads(resp.ranked_json)["ranked"]
|
||||
assert ranked[0] == {"id": "a", "score": 10}
|
||||
assert ranked[1] == {"id": "b", "score": 0}
|
||||
|
||||
|
||||
async def test_rebuild_export_unimplemented(grpc_channel) -> None:
|
||||
stub = pb_grpc.LingtaiEngineStub(grpc_channel)
|
||||
with pytest.raises(grpc.aio.AioRpcError) as exc:
|
||||
await stub.RebuildExport(pb.RebuildExportRequest(canonical_json="{}"))
|
||||
assert exc.value.code() == grpc.StatusCode.UNIMPLEMENTED
|
||||
Generated
+112
@@ -265,6 +265,90 @@ wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/df/af/419a4e383bd600858a9b67e9b280a60fdc383ee3f2fe5b6c0c1ef04e74d1/greenlet-3.5.5-cp315-cp315t-win_arm64.whl", hash = "sha256:7f049911ee81a16a03c33d5450d8d5867d27f596ca5fb201b86f4524e874468b", size = 315093, upload-time = "2026-08-10T13:29:34.949Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "grpcio"
|
||||
version = "1.83.1"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
dependencies = [
|
||||
{ name = "typing-extensions" },
|
||||
]
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/e2/b1/46539f5050d7c316a13396d185451f95084a74ddc68b12d818595bef0377/grpcio-1.83.1.tar.gz", hash = "sha256:9cee6fcbf2eb57c4b49451787bfa87be8efc1ca02a0b327dd4b54d44502e362b", size = 13445033, upload-time = "2026-08-28T07:09:11.464Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/85/9e/a3ba13e08bbee5bf6e57597dfe4823961fd7e94c0b8afe3a4bb7dca639f3/grpcio-1.83.1-cp312-cp312-linux_armv7l.whl", hash = "sha256:5acd14c6ddf047de62cbf8745b11103ea91abbf57d1b8edd5395ccd9fcd13abb", size = 6303170, upload-time = "2026-08-28T07:08:08.188Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/1c/ae/65ce56a2527faa17d02cba4c2231c74047ad898be339486ba87f093bfb66/grpcio-1.83.1-cp312-cp312-macosx_11_0_universal2.whl", hash = "sha256:16138031a47b771860a16a975b53087f4fd5bbdbb2c03a188c5d90ad65d2bdae", size = 12165806, upload-time = "2026-08-28T07:08:10.309Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/4e/91/40432480088a2243d360864de072ed5b78c4ebbaabd29c28918f1e1b1454/grpcio-1.83.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:5ccc26715fd4defca5e129e280dd883b1737b65045ec50ffe22ce42104089519", size = 6872490, upload-time = "2026-08-28T07:08:12.355Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/c8/62/3da2300c8c79fd20a78a8a4bb6251e5068d9af33bc8fd389b98fec35e8a3/grpcio-1.83.1-cp312-cp312-manylinux2014_i686.manylinux_2_17_i686.whl", hash = "sha256:b74f2a1d9ab1dfa3e263ef33d581613679b78d0884babf11671af26e45570ead", size = 7618367, upload-time = "2026-08-28T07:08:14.025Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/bc/19/9fc702e31a631262d7a752fa699f6022821e707fefc8bff49b1550a57729/grpcio-1.83.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:72578aa07a4008f17521ef52debcc3acfd1e2c5426243bc3ffb56a38bfe610b7", size = 7040936, upload-time = "2026-08-28T07:08:15.963Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/ec/56/95933cc44cba2429765fa065c951dd529e5771b119d9d2481b4646f1d6a5/grpcio-1.83.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:c12e1fc59c6dc26d10d9144453ddc6cbfe4cd4c31e874ed2d0132f88e685eb8b", size = 7573096, upload-time = "2026-08-28T07:08:17.729Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/ac/80/af63359da06b016de48cb111f144703a10043850dafa43ae0a038907b9e8/grpcio-1.83.1-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:4910b62f7d12197160bfb7de06d876d64dd12d43483e8292f98f49ca09b628d9", size = 8609442, upload-time = "2026-08-28T07:08:19.777Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/3d/fa/f0586c56bdfb8a7a2adda01e0ac2413447cde3141ab09411a5d5afdcffd3/grpcio-1.83.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:9e703effe3ae779925c82ac24fdb82cf4105e1096810151ed9501c5f34546b9c", size = 7984321, upload-time = "2026-08-28T07:08:22.114Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/25/8a/14ec05669f9eb295801e26c2ea8c561a1b786b0e3557c2c22131165ab010/grpcio-1.83.1-cp312-cp312-win32.whl", hash = "sha256:a2aea8bd6e0a34f12cbaddb7bb70bec836818789fa5c7ab7572c6b745396a2d4", size = 4395604, upload-time = "2026-08-28T07:08:24.08Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/e9/37/8c2f7cc16089e36a3fbacaacc7a3d043912aa0d2dfae5556f6450414ea6e/grpcio-1.83.1-cp312-cp312-win_amd64.whl", hash = "sha256:583bf2e8255040a4a312f9572dfe62a05271437b149550e1a536d5c47d2d1e8a", size = 5161512, upload-time = "2026-08-28T07:08:25.81Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/7c/fd/d1fc58933bf88c9209f89dc570c810f1aa57cb04b3459cf2b26f61e32112/grpcio-1.83.1-cp313-cp313-linux_armv7l.whl", hash = "sha256:8d228e253b77865efcbdd7b5894ca882c9e0ea98c02b7d20582e61ded8dfd4b5", size = 6305628, upload-time = "2026-08-28T07:08:27.872Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/c4/49/0b40bae059c619505c9b751cee6caa208e4904e290aaefa1728c4c2c67a5/grpcio-1.83.1-cp313-cp313-macosx_11_0_universal2.whl", hash = "sha256:0468b627f2987c9a77f7580030207cbd85457ffe52998beff4f0b5c38c58a72c", size = 12156839, upload-time = "2026-08-28T07:08:30.191Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/61/4b/e8c0d635da0ee5ddd9950c8d540f5dcdd0ef1854a382cc55496a487a8d31/grpcio-1.83.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:a6a282e81530cead60bbd752cc04950a57f224379e9821495d6a35bd5ce9b1f4", size = 6877036, upload-time = "2026-08-28T07:08:32.285Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/c5/d4/760a33f339a7dd3d5f4b3e0e9bec5472d95592a80f887b2e9dab4e41cfbc/grpcio-1.83.1-cp313-cp313-manylinux2014_i686.manylinux_2_17_i686.whl", hash = "sha256:947d945f52e8ecf3cafd2bb7113502a16ccfda3e12c854443094de32d83ad432", size = 7624404, upload-time = "2026-08-28T07:08:34.194Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/54/ec/bd798654b06fb42a92b57d1dc1b530084fa89ed442806fcd0a833a36f9b3/grpcio-1.83.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:55656318d5dd387077396dffb929171ca3966e24bfead9a6c5dba9f889062cb4", size = 7042942, upload-time = "2026-08-28T07:08:36.208Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/08/b0/c00f86614566dd0961825cf0f43d4f96a74371d9d95f952bcbc4b86d9a27/grpcio-1.83.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:9daf5acf4fc9d5f5627229969c2580a91e511779d76e4ccdeb9f4770f05d8bc2", size = 7576937, upload-time = "2026-08-28T07:08:38.041Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/b1/38/85eff43a5c89dc666a252b5c9f8e9ab03f89e11c95b6263d2933f08fdbe7/grpcio-1.83.1-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:7b94174cbca93316888f805efbeb08f1c020f7b7493d2d50cc4f6b64ebb7e8bd", size = 8608391, upload-time = "2026-08-28T07:08:40.092Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/35/4e/82835483e2f812494be865e7965c0d626cb9e71ab0d83a420d75aea4ad67/grpcio-1.83.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:65c5a7210911ffe0f67b1cdc5308f9854b6d1f1b345e3e49ab7cac1ba50fa346", size = 7980060, upload-time = "2026-08-28T07:08:42.434Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/b2/b7/68a98bef733fef704fbcfb3957c8dba67e3e38ca7a7fea851195bc97c648/grpcio-1.83.1-cp313-cp313-win32.whl", hash = "sha256:179368d9361854616ce6f397d4716e07480129652752fcbcfc5a7260455ad6f2", size = 4395226, upload-time = "2026-08-28T07:08:44.463Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/85/a0/df4de3b51d37ac8fb0320bb9668381ce2bd3b7aa990880bfc56a8a26f665/grpcio-1.83.1-cp313-cp313-win_amd64.whl", hash = "sha256:2e57af456385491a76e13c4aada8c8f43a8e47051e06ea97a9dbe2a49654e6db", size = 5160273, upload-time = "2026-08-28T07:08:46.216Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/42/9c/484d981d8b90c4e6abf3030bd2ed747e84d1eb192b3ec9cbb41e0b73e4bf/grpcio-1.83.1-cp314-cp314-linux_armv7l.whl", hash = "sha256:8b3c87ca908296bf125f841d3e1a2225a2b39aaa8ed7a57e7ccde465ee519bab", size = 6306089, upload-time = "2026-08-28T07:08:48.379Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/84/01/0afec1c92e4f292f74a44ecf75eabbf40903125b8c4df103c9868d6338da/grpcio-1.83.1-cp314-cp314-macosx_11_0_universal2.whl", hash = "sha256:c0f3f20c90e72a171917ae65706500b096a1c3eb5f162c3ce702a2e25635f132", size = 12170381, upload-time = "2026-08-28T07:08:50.653Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/c7/5a/e9a2383804433a0a61d6d93777ad321c7f36ac1cfdaa4c6d1a7c9ac846b7/grpcio-1.83.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:81bbf35a46bf8cad2dfbb2eccc19c711befb58b288acb534bbcd0d74283202a6", size = 6883286, upload-time = "2026-08-28T07:08:53.654Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/63/e7/f8ca8f76994e14c70b9a0052e82f10de497a23db450c36379c9716ebfc4d/grpcio-1.83.1-cp314-cp314-manylinux2014_i686.manylinux_2_17_i686.whl", hash = "sha256:215cec07d11176507387bda4bf2751816e880f9bff8dc1ca524bfbb8ed8f2fad", size = 7624293, upload-time = "2026-08-28T07:08:55.709Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/bb/7a/4b672814b0cd0fe63bdd735379d88b165759f3144ab023ad8ec5fc4d53ac/grpcio-1.83.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:abce7d43ec29cd39230fa8339de1a07643b55adc412a454850fbd875349950ff", size = 7044346, upload-time = "2026-08-28T07:08:57.802Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/50/b8/d89fe60e4239ad51be333dd9cc703741d449a35064e51f8a0b5bfa755432/grpcio-1.83.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:e256f95a40e3b0183a98556fb7164d24b97eeb353123ccabfcba94712b35ee2a", size = 7584187, upload-time = "2026-08-28T07:08:59.867Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/dc/b2/b290d7402633d9166e4dd47e6f5f74a24ce10a8340b84455896ebc349f85/grpcio-1.83.1-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:2110059146fb0ea216e1ffddb29377b5cc2fd412a5b0a92e102616bd5edf18c2", size = 8608730, upload-time = "2026-08-28T07:09:02.592Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/f5/44/fa89e44d1b5cf5b9fa71b2fd7abf506f182fd43917231a92fbf1ea326b02/grpcio-1.83.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:20d944d967843f8183f9f23d5916388362e5f8eeeae855bbe4354d906dc9f31b", size = 7983283, upload-time = "2026-08-28T07:09:05.087Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/ce/b8/9db73ed1f35ffa76124ac574bf296d06a359798dfd6b50d382f2b8a060a1/grpcio-1.83.1-cp314-cp314-win32.whl", hash = "sha256:623c87c6d4a1cb30d82c4e896f95477050f2e01b4a1f8cf91ff2b1abdf89c457", size = 4474327, upload-time = "2026-08-28T07:09:07.179Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/65/22/fc9a622d885a7a37ff972a12faaef443d74e47407181da70d0ab62ab41f0/grpcio-1.83.1-cp314-cp314-win_amd64.whl", hash = "sha256:47e6934ad38779271e2e7cc5f78a63a407cf3d98114c65c1fdbcd3f5a716f29b", size = 5302032, upload-time = "2026-08-28T07:09:09.285Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "grpcio-tools"
|
||||
version = "1.83.1"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
dependencies = [
|
||||
{ name = "grpcio" },
|
||||
{ name = "protobuf" },
|
||||
{ name = "setuptools" },
|
||||
]
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/8b/79/8b4131bcb94f09c2cac4919e627f20c09ba9b22320a307697d72b1f881d4/grpcio_tools-1.83.1.tar.gz", hash = "sha256:a8148eece396f8a349097958bc00f14882003331f3b7c2ae8079c1c632d17d6f", size = 6399877, upload-time = "2026-08-28T07:10:56.19Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/03/91/79261571a7e5f6b5526f2da0fb7bff680af94f5322c8e8923961cbe801ae/grpcio_tools-1.83.1-cp312-cp312-linux_armv7l.whl", hash = "sha256:3a8931c167e52741f72795c67f45435faaefb7ce8e9aa9413ba523ddaa358998", size = 2653283, upload-time = "2026-08-28T07:09:59.056Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/03/b2/ea313245d23b0a77edc83b1f01b86304664e79e2221d11cc8cf92985f18b/grpcio_tools-1.83.1-cp312-cp312-macosx_11_0_universal2.whl", hash = "sha256:d559e85272145a979e9ad10be2740d953dcd21c37cdad159f06cd7eaf887c898", size = 5965913, upload-time = "2026-08-28T07:10:00.727Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/31/ce/125baf82bba77fad398f6139bda5e4383208a5a7f9f1ffc42dd8d973c402/grpcio_tools-1.83.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:169518957cbc23034950006f3eb77514516476496b2951576c531336c61baffb", size = 2705430, upload-time = "2026-08-28T07:10:02.324Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/bc/7c/cc727ab1b4ecc0a6dfe706a714c959d86736153c811e38b5b6723cb7576d/grpcio_tools-1.83.1-cp312-cp312-manylinux2014_i686.manylinux_2_17_i686.whl", hash = "sha256:d0e9b58917beb6e13d40bb694390dc79c8d7652a1d9ff412e98bdb416d8b135e", size = 3033411, upload-time = "2026-08-28T07:10:04.255Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/84/57/e0312f16529cde4de03f532bb8dd4a8ccbf314e7c40cdfdc5586b6c23f85/grpcio_tools-1.83.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:70c74bb6fe0b57b7f4f49caa21d3263e149c2f1e2ef9d53c3d78d622e8564deb", size = 2774499, upload-time = "2026-08-28T07:10:05.928Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/b7/83/0ecd3ee6ae20da8454481adf489969f854c56f702fcd2f27b5583fc14eae/grpcio_tools-1.83.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:91a3d0939364e688773c2735286e61107fbacdc104711b0003bd665986b79993", size = 3229873, upload-time = "2026-08-28T07:10:07.576Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/09/03/92d4a193578efc5e4a061339dd0dbdcf516eebdb0577646b1bfaf144c803/grpcio_tools-1.83.1-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:479bb9f4bde497471717e0ee59ed5635b490af954224825bd7006608d1e76d79", size = 3803165, upload-time = "2026-08-28T07:10:09.67Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/b2/51/9921cf100111c0e1ba375767cab93be3036b231f22533985ddb497111d4f/grpcio_tools-1.83.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:b57f41c87ba0ea0d13d98b696058864d3dea949ecb4a376c3a4a52857330b83f", size = 3461813, upload-time = "2026-08-28T07:10:11.594Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/75/77/7fd50b572b38670886e1c41986b785720e24a4b0be8b164fa09e2d915782/grpcio_tools-1.83.1-cp312-cp312-win32.whl", hash = "sha256:eaf9217d67960016fdd2932f28239ec14716a15b783baa8d4b012937098531f1", size = 1022492, upload-time = "2026-08-28T07:10:13.144Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/cd/68/45e04d9a921e10158b84b099dbdd25e6d56776d508872c68922a61ff85fd/grpcio_tools-1.83.1-cp312-cp312-win_amd64.whl", hash = "sha256:dcbdd3422ca50ed6f880f9974df50796fb355f4051c55a464423a6423a3f0393", size = 1192288, upload-time = "2026-08-28T07:10:14.777Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/d7/34/917a23240209fa5e020d68522b3d11d00da2acc8a784e215aec37b66cc0a/grpcio_tools-1.83.1-cp313-cp313-linux_armv7l.whl", hash = "sha256:7c4ebbf3b13e481134fdf40fa49cb1f570ccb6b1a52c9ccded260428d79add6a", size = 2652846, upload-time = "2026-08-28T07:10:16.778Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/1e/b3/e0e2c3cfb5bb1311f11fce1176f47d84374e592ca6abf64d579c9dff701c/grpcio_tools-1.83.1-cp313-cp313-macosx_11_0_universal2.whl", hash = "sha256:fe937a0cb78397abdf3ece759beed1fe5763dc530d8165b8b8691cc0770f2523", size = 5963532, upload-time = "2026-08-28T07:10:18.731Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/42/38/ce3d17a54ae754bed008303420e3ab88e8c26bd1e97722df188ee22b4583/grpcio_tools-1.83.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:93970064770f45789796c579c9e70fd2371621f5e2c07e64cf0decf7b41d8b6c", size = 2705094, upload-time = "2026-08-28T07:10:20.534Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/b2/74/049150098e3dac26053f03d0b3e2f25da354c476302c6a31bb287f1a8493/grpcio_tools-1.83.1-cp313-cp313-manylinux2014_i686.manylinux_2_17_i686.whl", hash = "sha256:2c8c845f2b7d5a229377e3b10ffa281a93fb73e436a0078dc4a58c761ed32434", size = 3033063, upload-time = "2026-08-28T07:10:22.268Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/40/fe/e9ec5fb11997318f7dabb1ff7b910b2f76d30c570d0ba56150733f256c25/grpcio_tools-1.83.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:8e15a089141788fe1268044ccdc43e1467c92d60387ebaf289dfd22a68227d16", size = 2773648, upload-time = "2026-08-28T07:10:23.979Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/b4/05/92c1d00dd71fcce02e928f3895571e07b030463ce45e187d162317fcfadf/grpcio_tools-1.83.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:9b7a57ce7ee79917d6db94d7ff8356e91c6768b9db62f26f03cd628ec5aacb0b", size = 3229788, upload-time = "2026-08-28T07:10:25.879Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/c2/f5/974254c820c5e1f391f7f4cbade03befde72808d8323bbf9d2422614ce17/grpcio_tools-1.83.1-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:fff7380f022deb12e4ca6cf9b26ef0000c1cf9ec8b2af2675a3b5afe42f68828", size = 3802531, upload-time = "2026-08-28T07:10:27.896Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/88/c2/816b26ee8f4353ea3207dae5691b08ea9bf53e6a4bacc798742bd3066c66/grpcio_tools-1.83.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:0bcb9d5f1f0cd550a45ac811f5bdf5241df1f924ac7c70d186eba7d9a6260e9c", size = 3461030, upload-time = "2026-08-28T07:10:29.611Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/75/ab/a4c629a5cacaefd468dd8152269dd3a578dd0e8858ed8691878a9c3f545f/grpcio_tools-1.83.1-cp313-cp313-win32.whl", hash = "sha256:08197f91352f0944957372b2c82a4fc64d522b75b5c8c4cdc47186e20e4f7fb6", size = 1022120, upload-time = "2026-08-28T07:10:31.233Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/ad/37/b62a44c72df3cc61917f9d7cc42af0d32f60e7ca8b892dfcd95330eae68b/grpcio_tools-1.83.1-cp313-cp313-win_amd64.whl", hash = "sha256:5e9eb45376a8e1d22e2ef067518616738272de223cbb13b2424d7880d04e4dbe", size = 1191938, upload-time = "2026-08-28T07:10:33.108Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/34/2b/4e8f3bff52b933c52c853e3a51db8d5e87c71fc0ec3903ef9e432b25e4c5/grpcio_tools-1.83.1-cp314-cp314-linux_armv7l.whl", hash = "sha256:f54955b95b17e83f8075303a31fa8f1aa64ad22d6f046e0070e9973918327202", size = 2652838, upload-time = "2026-08-28T07:10:35.035Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/91/01/f5b3648285126a741a1a60108971c25acb0532af8fd2ffb29990747ff8d8/grpcio_tools-1.83.1-cp314-cp314-macosx_11_0_universal2.whl", hash = "sha256:0f4c3d39546b0e6add25affd096170347c10437d78189fe2d0a026f7cbc5cb57", size = 5963473, upload-time = "2026-08-28T07:10:37.213Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/65/1d/95fc82961423365edc3ac6f98bc12ac96429bfbc5c43ede9ff40354aa273/grpcio_tools-1.83.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:34c8bbfe6e1ed19524010351a27c0d43e185b3d542cf4ab83ad9774d4c9000e1", size = 2705302, upload-time = "2026-08-28T07:10:39.166Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/e4/c5/82e29f48fcb5cf77b78c427ccaf5808b1b276cadd42955ceec960ec8daff/grpcio_tools-1.83.1-cp314-cp314-manylinux2014_i686.manylinux_2_17_i686.whl", hash = "sha256:004bef39f47db3ed93caf58175ad3d3800f53d16a04b493166be945a0b575df3", size = 3033047, upload-time = "2026-08-28T07:10:41.492Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/89/38/f17b2902166320912fff7ecb4227a69ddf8edb544702045c3aba3076de0a/grpcio_tools-1.83.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:41a4ce8c2cddb38b50d5befe4f40b124f77d68021e2e47f80142f6138d802d8f", size = 2773829, upload-time = "2026-08-28T07:10:43.367Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/df/c5/974b54afc6ea3d7d8b51671d0c64effd9a92691a887e9bbf62c8b6213f03/grpcio_tools-1.83.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:b52cc836922456d56f25ff63b277410a6d9ad682863f064c1f735a19328432a3", size = 3229905, upload-time = "2026-08-28T07:10:45.758Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/8a/87/e9d5ff123ff80d0a7d502e9d2452305812d904e17afb88b3b23d892f3334/grpcio_tools-1.83.1-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:b73afd4303f2b026f8d8f3d7f07f5f22a2f2c3ecb05758af30205db0b16539b9", size = 3802600, upload-time = "2026-08-28T07:10:47.977Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/4f/2f/66d8cdc5a81f9723f2b7b2f32d29a757b3bd2eac2116746014626feb83d6/grpcio_tools-1.83.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:df9a2b346b98ec28d5666b43d2c00bb533976faa13f3fab2897890b3703a968a", size = 3461303, upload-time = "2026-08-28T07:10:50.178Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/dd/f3/3989a42f1dcc1a1c59f06f5e4fbf48bc50a53a6cc5083c0b6a7aef4c1929/grpcio_tools-1.83.1-cp314-cp314-win32.whl", hash = "sha256:a8cafccbe4b83bcc297920796ae5a784c700c9fbef01705397007bcb4652e070", size = 1045048, upload-time = "2026-08-28T07:10:52.123Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/11/bf/be8370e2c3f0108aaae33bd609c359d593648959cc9efe69e6b59ec88a41/grpcio_tools-1.83.1-cp314-cp314-win_amd64.whl", hash = "sha256:9a40b779ec4bbd042279957cd1d0f42d4cbe333878d3d59ceeebe1cf3148528a", size = 1224200, upload-time = "2026-08-28T07:10:54.085Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "h11"
|
||||
version = "0.16.0"
|
||||
@@ -347,6 +431,8 @@ dependencies = [
|
||||
{ name = "asyncpg" },
|
||||
{ name = "fastapi" },
|
||||
{ name = "greenlet" },
|
||||
{ name = "grpcio" },
|
||||
{ name = "grpcio-tools" },
|
||||
{ name = "hunjing-lingtai" },
|
||||
{ name = "pydantic" },
|
||||
{ name = "pydantic-settings" },
|
||||
@@ -370,6 +456,8 @@ requires-dist = [
|
||||
{ name = "asyncpg", specifier = ">=0.30" },
|
||||
{ name = "fastapi", specifier = ">=0.115" },
|
||||
{ name = "greenlet", specifier = ">=3.5.5" },
|
||||
{ name = "grpcio", specifier = ">=1.83.1" },
|
||||
{ name = "grpcio-tools", specifier = ">=1.83.1" },
|
||||
{ name = "hunjing-lingtai", editable = "../engine/bindings" },
|
||||
{ name = "pydantic", specifier = ">=2.9" },
|
||||
{ name = "pydantic-settings", specifier = ">=2.6" },
|
||||
@@ -676,6 +764,21 @@ wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "protobuf"
|
||||
version = "7.36.1"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/86/73/f66c748df06e7fe24e658eddd600d19c4b40bad836c97ce2d0ad9851fb6b/protobuf-7.36.1.tar.gz", hash = "sha256:d0f6470f0ce2b84e3feaea2d4b816378b37ba4d4aa08a274305373de93e2d524", size = 512499, upload-time = "2026-08-31T22:40:04.667Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/f7/6c/3a54a58f2948b0f485df9ecdd06590f15d0a7abf46a89d50c3de709ff4ff/protobuf-7.36.1-cp310-abi3-macosx_10_9_universal2.whl", hash = "sha256:3cf2ee25d006cee57294a1196ea43b37feb78e0dcd1e8af5c1aeddb777655aca", size = 456046, upload-time = "2026-08-31T22:39:56.865Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/6e/08/9f9548793c771095245c0eeaf0c84b76b16a5ef26158043d456f551344a0/protobuf-7.36.1-cp310-abi3-manylinux2014_aarch64.whl", hash = "sha256:43d3d37b1eb24c113b9b7d02008cac44e423f00b611b7781ae998d7623972969", size = 344226, upload-time = "2026-08-31T22:39:58.263Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/fe/51/1bdbd612fa3c51e42ea6f45d05e84dc748ddcd2663e1aa1e89a00a33facd/protobuf-7.36.1-cp310-abi3-manylinux2014_s390x.whl", hash = "sha256:39c518c05586c016d7874ff6079ee115bcec1ea5fbb1d177fbf7867ef4c67e44", size = 357229, upload-time = "2026-08-31T22:39:59.198Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/22/df/c799fe7a05ef16ba853a59db01f3a2c5f7d0676469589ccc4874f76a2a88/protobuf-7.36.1-cp310-abi3-manylinux2014_x86_64.whl", hash = "sha256:97198b77e369a0abd8e262b8f6c7266c55ddb796a3a12c76d7b8881188ed83aa", size = 343228, upload-time = "2026-08-31T22:40:00.179Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/3d/33/d4724ec5d86d496fe4108e220618aa0837ad3423a7af7ccdd9684ccc77c8/protobuf-7.36.1-cp310-abi3-win32.whl", hash = "sha256:0b53ce95272aad50ad25d7ff03373743209822e8ba42ea7fad27d2bee1547d00", size = 443002, upload-time = "2026-08-31T22:40:01.32Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/db/37/155788a0d8daded960375af604202805308169f9b859419ea0aa370946e2/protobuf-7.36.1-cp310-abi3-win_amd64.whl", hash = "sha256:51139351435d9b43d88a55eaa49fb6f737fbb478fb0cbf2cf694d1a04a9d3363", size = 456518, upload-time = "2026-08-31T22:40:02.494Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/39/ca/c47f91d3cab175b01fd8c4f0d80fdf8613be876cc616e66ad281a59c5ddf/protobuf-7.36.1-py3-none-any.whl", hash = "sha256:7d951e46b3f963d6c264c367c437921de9d5aedd9c3f9612b9077736b4e3ad5c", size = 179813, upload-time = "2026-08-31T22:40:03.54Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "pydantic"
|
||||
version = "2.13.5"
|
||||
@@ -898,6 +1001,15 @@ wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/fc/07/d781f8f8e1ac24bef9f3269cf62ffb1407ca24c3a8f12e5e22874f90528c/ruff-0.16.6-py3-none-win_arm64.whl", hash = "sha256:7a976c79b958f94e50a022a19f0f8c87387448020935ec14fc74331bd0a7f2c5", size = 10412850, upload-time = "2026-09-03T16:57:26.416Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "setuptools"
|
||||
version = "84.0.0"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/6d/44/f5da03a8ef95d369145c5bb53050e7877c9f3d312e128605fd9504829143/setuptools-84.0.0.tar.gz", hash = "sha256:f4695c21257f0d9b537ec2692c941d02ee143b7cc1276941349a546573b2ef73", size = 1168449, upload-time = "2026-08-08T18:27:58.365Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/95/9c/c510029fc6ef33a6275cd2c5d3cecd6613dfd6aa401d57c54f1c18852ccf/setuptools-84.0.0-py3-none-any.whl", hash = "sha256:51a52592b3b99e102b609654876bd65f19f999935166d1352678931132b0c670", size = 818216, upload-time = "2026-08-08T18:27:56.719Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "sqlalchemy"
|
||||
version = "2.0.52"
|
||||
|
||||
@@ -0,0 +1,127 @@
|
||||
syntax = "proto3";
|
||||
|
||||
package liushen.v1;
|
||||
|
||||
// 灵台引擎独立服务形态（契约 docs/contracts/lingtai-service.md）。
|
||||
// 部署内部网络专用；错误映射见契约第 6 节。字段语义与进程内 C ABI JSON 边界同源。
|
||||
|
||||
service LingtaiEngine {
|
||||
// 版本、ABI major、parser version、能力位
|
||||
rpc GetEngineInfo(GetEngineInfoRequest) returns (GetEngineInfoResponse);
|
||||
|
||||
// Markdown → canonical ContentBlock JSON
|
||||
rpc TransformMarkdown(TransformMarkdownRequest) returns (TransformMarkdownResponse);
|
||||
|
||||
// canonical Block → 可移植 Markdown 重建（预留：实现随 WP-03 导出）
|
||||
rpc RebuildExport(RebuildExportRequest) returns (RebuildExportResponse);
|
||||
|
||||
// 双向流：宿主喂增量，服务回 content.block.* envelope JSON
|
||||
rpc OpenStream(stream StreamFrame) returns (stream StreamEvent);
|
||||
|
||||
// 计划 DAG 预算核算（最小：标量预算）
|
||||
rpc CheckBudget(CheckBudgetRequest) returns (CheckBudgetResponse);
|
||||
|
||||
// 候选确定性重排
|
||||
rpc RerankRecall(RerankRecallRequest) returns (RerankRecallResponse);
|
||||
|
||||
// 四维裁决（autonomy × risk）
|
||||
rpc EvaluatePolicy(EvaluatePolicyRequest) returns (EvaluatePolicyResponse);
|
||||
|
||||
// URL 协议白名单校验
|
||||
rpc ValidateUrl(ValidateUrlRequest) returns (ValidateUrlResponse);
|
||||
|
||||
// Run/Turn 状态转换合法性
|
||||
rpc CheckStateTransition(CheckStateTransitionRequest) returns (CheckStateTransitionResponse);
|
||||
}
|
||||
|
||||
message GetEngineInfoRequest {}
|
||||
|
||||
message GetEngineInfoResponse {
|
||||
uint32 abi_major = 1;
|
||||
string parser_version = 2;
|
||||
string engine_version = 3;
|
||||
repeated string capabilities = 4;
|
||||
}
|
||||
|
||||
message TransformMarkdownRequest {
|
||||
string markdown = 1;
|
||||
}
|
||||
|
||||
message TransformMarkdownResponse {
|
||||
string canonical_json = 1; // canonical ContentBlock JSON（键序确定）
|
||||
}
|
||||
|
||||
message RebuildExportRequest {
|
||||
string canonical_json = 1;
|
||||
}
|
||||
|
||||
message RebuildExportResponse {
|
||||
string markdown = 1;
|
||||
}
|
||||
|
||||
message StreamFrame {
|
||||
oneof frame {
|
||||
string block_started = 2; // block_id：开启新 block（重置 delta_index）
|
||||
string text_delta = 3; // 文本增量
|
||||
}
|
||||
}
|
||||
|
||||
message StreamEvent {
|
||||
string event_json = 1; // content.block.* envelope（canonical JSON）
|
||||
}
|
||||
|
||||
message CheckBudgetRequest {
|
||||
int64 used = 1;
|
||||
int64 maximum = 2;
|
||||
}
|
||||
|
||||
message CheckBudgetResponse {
|
||||
bool allowed = 1;
|
||||
string reason = 2;
|
||||
}
|
||||
|
||||
message RerankRecallRequest {
|
||||
string candidates_json = 1;
|
||||
}
|
||||
|
||||
message RerankRecallResponse {
|
||||
string ranked_json = 1;
|
||||
}
|
||||
|
||||
message EvaluatePolicyRequest {
|
||||
int32 autonomy_level = 1; // 0 自省 / 1 循律 / 2 请命 / 3 禁域
|
||||
int32 risk_level = 2; // 0 只读 / 1 副作用 / 2 高影响
|
||||
}
|
||||
|
||||
message EvaluatePolicyResponse {
|
||||
int32 decision = 1; // 0 allow / 1 ask / 2 deny
|
||||
}
|
||||
|
||||
message ValidateUrlRequest {
|
||||
string url = 1;
|
||||
}
|
||||
|
||||
message ValidateUrlResponse {
|
||||
bool allowed = 1;
|
||||
string reason = 2;
|
||||
}
|
||||
|
||||
enum RunStatus {
|
||||
RUN_STATUS_UNSPECIFIED = 0;
|
||||
RUN_STATUS_QUEUED = 1;
|
||||
RUN_STATUS_RUNNING = 2;
|
||||
RUN_STATUS_WAITING_APPROVAL = 3;
|
||||
RUN_STATUS_COMPLETED = 4;
|
||||
RUN_STATUS_FAILED = 5;
|
||||
RUN_STATUS_CANCELLED = 6;
|
||||
}
|
||||
|
||||
message CheckStateTransitionRequest {
|
||||
RunStatus from = 1;
|
||||
RunStatus to = 2;
|
||||
}
|
||||
|
||||
message CheckStateTransitionResponse {
|
||||
bool valid = 1;
|
||||
string reason = 2;
|
||||
}
|
||||
Whitespace-only changes.
Whitespace-only changes.
@@ -0,0 +1,74 @@
|
||||
# -*- coding: utf-8 -*-
|
||||
# Generated by the protocol buffer compiler. DO NOT EDIT!
|
||||
# NO CHECKED-IN PROTOBUF GENCODE
|
||||
# source: liushen/v1/liushen.proto
|
||||
# Protobuf Python Version: 7.35.1
|
||||
"""Generated protocol buffer code."""
|
||||
from google.protobuf import descriptor as _descriptor
|
||||
from google.protobuf import descriptor_pool as _descriptor_pool
|
||||
from google.protobuf import runtime_version as _runtime_version
|
||||
from google.protobuf import symbol_database as _symbol_database
|
||||
from google.protobuf.internal import builder as _builder
|
||||
_runtime_version.ValidateProtobufRuntimeVersion(
|
||||
_runtime_version.Domain.PUBLIC,
|
||||
7,
|
||||
35,
|
||||
1,
|
||||
'',
|
||||
'liushen/v1/liushen.proto'
|
||||
)
|
||||
# @@protoc_insertion_point(imports)
|
||||
|
||||
_sym_db = _symbol_database.Default()
|
||||
|
||||
|
||||
|
||||
|
||||
DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x18liushen/v1/liushen.proto\x12\nliushen.v1\"\x16\n\x14GetEngineInfoRequest\"p\n\x15GetEngineInfoResponse\x12\x11\n\tabi_major\x18\x01 \x01(\r\x12\x16\n\x0eparser_version\x18\x02 \x01(\t\x12\x16\n\x0e\x65ngine_version\x18\x03 \x01(\t\x12\x14\n\x0c\x63\x61pabilities\x18\x04 \x03(\t\",\n\x18TransformMarkdownRequest\x12\x10\n\x08markdown\x18\x01 \x01(\t\"3\n\x19TransformMarkdownResponse\x12\x16\n\x0e\x63\x61nonical_json\x18\x01 \x01(\t\".\n\x14RebuildExportRequest\x12\x16\n\x0e\x63\x61nonical_json\x18\x01 \x01(\t\")\n\x15RebuildExportResponse\x12\x10\n\x08markdown\x18\x01 \x01(\t\"E\n\x0bStreamFrame\x12\x17\n\rblock_started\x18\x02 \x01(\tH\x00\x12\x14\n\ntext_delta\x18\x03 \x01(\tH\x00\x42\x07\n\x05\x66rame\"!\n\x0bStreamEvent\x12\x12\n\nevent_json\x18\x01 \x01(\t\"3\n\x12\x43heckBudgetRequest\x12\x0c\n\x04used\x18\x01 \x01(\x03\x12\x0f\n\x07maximum\x18\x02 \x01(\x03\"6\n\x13\x43heckBudgetResponse\x12\x0f\n\x07\x61llowed\x18\x01 \x01(\x08\x12\x0e\n\x06reason\x18\x02 \x01(\t\".\n\x13RerankRecallRequest\x12\x17\n\x0f\x63\x61ndidates_json\x18\x01 \x01(\t\"+\n\x14RerankRecallResponse\x12\x13\n\x0branked_json\x18\x01 \x01(\t\"C\n\x15\x45valuatePolicyRequest\x12\x16\n\x0e\x61utonomy_level\x18\x01 \x01(\x05\x12\x12\n\nrisk_level\x18\x02 \x01(\x05\"*\n\x16\x45valuatePolicyResponse\x12\x10\n\x08\x64\x65\x63ision\x18\x01 \x01(\x05\"!\n\x12ValidateUrlRequest\x12\x0b\n\x03url\x18\x01 \x01(\t\"6\n\x13ValidateUrlResponse\x12\x0f\n\x07\x61llowed\x18\x01 \x01(\x08\x12\x0e\n\x06reason\x18\x02 \x01(\t\"e\n\x1b\x43heckStateTransitionRequest\x12#\n\x04\x66rom\x18\x01 \x01(\x0e\x32\x15.liushen.v1.RunStatus\x12!\n\x02to\x18\x02 \x01(\x0e\x32\x15.liushen.v1.RunStatus\"=\n\x1c\x43heckStateTransitionResponse\x12\r\n\x05valid\x18\x01 \x01(\x08\x12\x0e\n\x06reason\x18\x02 \x01(\t*\xc2\x01\n\tRunStatus\x12\x1a\n\x16RUN_STATUS_UNSPECIFIED\x10\x00\x12\x15\n\x11RUN_STATUS_QUEUED\x10\x01\x12\x16\n\x12RUN_STATUS_RUNNING\x10\x02\x12\x1f\n\x1bRUN_STATUS_WAITING_APPROVAL\x10\x03\x12\x18\n\x14RUN_STATUS_COMPLETED\x10\x04\x12\x15\n\x11RUN_STATUS_FAILED\x10\x05\x12\x18\n\x14RUN_STATUS_CANCELLED\x10\x06\x32\x98\x06\n\rLingtaiEngine\x12T\n\rGetEngineInfo\x12 .liushen.v1.GetEngineInfoRequest\x1a!.liushen.v1.GetEngineInfoResponse\x12`\n\x11TransformMarkdown\x12$.liushen.v1.TransformMarkdownRequest\x1a%.liushen.v1.TransformMarkdownResponse\x12T\n\rRebuildExport\x12 .liushen.v1.RebuildExportRequest\x1a!.liushen.v1.RebuildExportResponse\x12\x42\n\nOpenStream\x12\x17.liushen.v1.StreamFrame\x1a\x17.liushen.v1.StreamEvent(\x01\x30\x01\x12N\n\x0b\x43heckBudget\x12\x1e.liushen.v1.CheckBudgetRequest\x1a\x1f.liushen.v1.CheckBudgetResponse\x12Q\n\x0cRerankRecall\x12\x1f.liushen.v1.RerankRecallRequest\x1a .liushen.v1.RerankRecallResponse\x12W\n\x0e\x45valuatePolicy\x12!.liushen.v1.EvaluatePolicyRequest\x1a\".liushen.v1.EvaluatePolicyResponse\x12N\n\x0bValidateUrl\x12\x1e.liushen.v1.ValidateUrlRequest\x1a\x1f.liushen.v1.ValidateUrlResponse\x12i\n\x14\x43heckStateTransition\x12\'.liushen.v1.CheckStateTransitionRequest\x1a(.liushen.v1.CheckStateTransitionResponseb\x06proto3')
|
||||
|
||||
_globals = globals()
|
||||
_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
|
||||
_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'liushen.v1.liushen_pb2', _globals)
|
||||
if not _descriptor._USE_C_DESCRIPTORS:
|
||||
DESCRIPTOR._loaded_options = None
|
||||
_globals['_RUNSTATUS']._serialized_start=1047
|
||||
_globals['_RUNSTATUS']._serialized_end=1241
|
||||
_globals['_GETENGINEINFOREQUEST']._serialized_start=40
|
||||
_globals['_GETENGINEINFOREQUEST']._serialized_end=62
|
||||
_globals['_GETENGINEINFORESPONSE']._serialized_start=64
|
||||
_globals['_GETENGINEINFORESPONSE']._serialized_end=176
|
||||
_globals['_TRANSFORMMARKDOWNREQUEST']._serialized_start=178
|
||||
_globals['_TRANSFORMMARKDOWNREQUEST']._serialized_end=222
|
||||
_globals['_TRANSFORMMARKDOWNRESPONSE']._serialized_start=224
|
||||
_globals['_TRANSFORMMARKDOWNRESPONSE']._serialized_end=275
|
||||
_globals['_REBUILDEXPORTREQUEST']._serialized_start=277
|
||||
_globals['_REBUILDEXPORTREQUEST']._serialized_end=323
|
||||
_globals['_REBUILDEXPORTRESPONSE']._serialized_start=325
|
||||
_globals['_REBUILDEXPORTRESPONSE']._serialized_end=366
|
||||
_globals['_STREAMFRAME']._serialized_start=368
|
||||
_globals['_STREAMFRAME']._serialized_end=437
|
||||
_globals['_STREAMEVENT']._serialized_start=439
|
||||
_globals['_STREAMEVENT']._serialized_end=472
|
||||
_globals['_CHECKBUDGETREQUEST']._serialized_start=474
|
||||
_globals['_CHECKBUDGETREQUEST']._serialized_end=525
|
||||
_globals['_CHECKBUDGETRESPONSE']._serialized_start=527
|
||||
_globals['_CHECKBUDGETRESPONSE']._serialized_end=581
|
||||
_globals['_RERANKRECALLREQUEST']._serialized_start=583
|
||||
_globals['_RERANKRECALLREQUEST']._serialized_end=629
|
||||
_globals['_RERANKRECALLRESPONSE']._serialized_start=631
|
||||
_globals['_RERANKRECALLRESPONSE']._serialized_end=674
|
||||
_globals['_EVALUATEPOLICYREQUEST']._serialized_start=676
|
||||
_globals['_EVALUATEPOLICYREQUEST']._serialized_end=743
|
||||
_globals['_EVALUATEPOLICYRESPONSE']._serialized_start=745
|
||||
_globals['_EVALUATEPOLICYRESPONSE']._serialized_end=787
|
||||
_globals['_VALIDATEURLREQUEST']._serialized_start=789
|
||||
_globals['_VALIDATEURLREQUEST']._serialized_end=822
|
||||
_globals['_VALIDATEURLRESPONSE']._serialized_start=824
|
||||
_globals['_VALIDATEURLRESPONSE']._serialized_end=878
|
||||
_globals['_CHECKSTATETRANSITIONREQUEST']._serialized_start=880
|
||||
_globals['_CHECKSTATETRANSITIONREQUEST']._serialized_end=981
|
||||
_globals['_CHECKSTATETRANSITIONRESPONSE']._serialized_start=983
|
||||
_globals['_CHECKSTATETRANSITIONRESPONSE']._serialized_end=1044
|
||||
_globals['_LINGTAIENGINE']._serialized_start=1244
|
||||
_globals['_LINGTAIENGINE']._serialized_end=2036
|
||||
# @@protoc_insertion_point(module_scope)
|
||||
@@ -0,0 +1,459 @@
|
||||
# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
|
||||
"""Client and server classes corresponding to protobuf-defined services."""
|
||||
import grpc
|
||||
import warnings
|
||||
|
||||
from liushen.v1 import liushen_pb2 as liushen_dot_v1_dot_liushen__pb2
|
||||
|
||||
GRPC_GENERATED_VERSION = '1.83.1'
|
||||
GRPC_VERSION = grpc.__version__
|
||||
_version_not_supported = False
|
||||
|
||||
try:
|
||||
from grpc._utilities import first_version_is_lower
|
||||
_version_not_supported = first_version_is_lower(GRPC_VERSION, GRPC_GENERATED_VERSION)
|
||||
except ImportError:
|
||||
_version_not_supported = True
|
||||
|
||||
if _version_not_supported:
|
||||
raise RuntimeError(
|
||||
f'The grpc package installed is at version {GRPC_VERSION},'
|
||||
+ ' but the generated code in liushen/v1/liushen_pb2_grpc.py depends on'
|
||||
+ f' grpcio>={GRPC_GENERATED_VERSION}.'
|
||||
+ f' Please upgrade your grpc module to grpcio>={GRPC_GENERATED_VERSION}'
|
||||
+ f' or downgrade your generated code using grpcio-tools<={GRPC_VERSION}.'
|
||||
)
|
||||
|
||||
|
||||
class LingtaiEngineStub:
|
||||
"""灵台引擎独立服务形态（契约 docs/contracts/lingtai-service.md）。
|
||||
部署内部网络专用；错误映射见契约第 6 节。字段语义与进程内 C ABI JSON 边界同源。
|
||||
|
||||
"""
|
||||
|
||||
def __init__(self, channel):
|
||||
"""Constructor.
|
||||
|
||||
Args:
|
||||
channel: A grpc.Channel.
|
||||
"""
|
||||
self.GetEngineInfo = channel.unary_unary(
|
||||
'/liushen.v1.LingtaiEngine/GetEngineInfo',
|
||||
request_serializer=liushen_dot_v1_dot_liushen__pb2.GetEngineInfoRequest.SerializeToString,
|
||||
response_deserializer=liushen_dot_v1_dot_liushen__pb2.GetEngineInfoResponse.FromString,
|
||||
_registered_method=True)
|
||||
self.TransformMarkdown = channel.unary_unary(
|
||||
'/liushen.v1.LingtaiEngine/TransformMarkdown',
|
||||
request_serializer=liushen_dot_v1_dot_liushen__pb2.TransformMarkdownRequest.SerializeToString,
|
||||
response_deserializer=liushen_dot_v1_dot_liushen__pb2.TransformMarkdownResponse.FromString,
|
||||
_registered_method=True)
|
||||
self.RebuildExport = channel.unary_unary(
|
||||
'/liushen.v1.LingtaiEngine/RebuildExport',
|
||||
request_serializer=liushen_dot_v1_dot_liushen__pb2.RebuildExportRequest.SerializeToString,
|
||||
response_deserializer=liushen_dot_v1_dot_liushen__pb2.RebuildExportResponse.FromString,
|
||||
_registered_method=True)
|
||||
self.OpenStream = channel.stream_stream(
|
||||
'/liushen.v1.LingtaiEngine/OpenStream',
|
||||
request_serializer=liushen_dot_v1_dot_liushen__pb2.StreamFrame.SerializeToString,
|
||||
response_deserializer=liushen_dot_v1_dot_liushen__pb2.StreamEvent.FromString,
|
||||
_registered_method=True)
|
||||
self.CheckBudget = channel.unary_unary(
|
||||
'/liushen.v1.LingtaiEngine/CheckBudget',
|
||||
request_serializer=liushen_dot_v1_dot_liushen__pb2.CheckBudgetRequest.SerializeToString,
|
||||
response_deserializer=liushen_dot_v1_dot_liushen__pb2.CheckBudgetResponse.FromString,
|
||||
_registered_method=True)
|
||||
self.RerankRecall = channel.unary_unary(
|
||||
'/liushen.v1.LingtaiEngine/RerankRecall',
|
||||
request_serializer=liushen_dot_v1_dot_liushen__pb2.RerankRecallRequest.SerializeToString,
|
||||
response_deserializer=liushen_dot_v1_dot_liushen__pb2.RerankRecallResponse.FromString,
|
||||
_registered_method=True)
|
||||
self.EvaluatePolicy = channel.unary_unary(
|
||||
'/liushen.v1.LingtaiEngine/EvaluatePolicy',
|
||||
request_serializer=liushen_dot_v1_dot_liushen__pb2.EvaluatePolicyRequest.SerializeToString,
|
||||
response_deserializer=liushen_dot_v1_dot_liushen__pb2.EvaluatePolicyResponse.FromString,
|
||||
_registered_method=True)
|
||||
self.ValidateUrl = channel.unary_unary(
|
||||
'/liushen.v1.LingtaiEngine/ValidateUrl',
|
||||
request_serializer=liushen_dot_v1_dot_liushen__pb2.ValidateUrlRequest.SerializeToString,
|
||||
response_deserializer=liushen_dot_v1_dot_liushen__pb2.ValidateUrlResponse.FromString,
|
||||
_registered_method=True)
|
||||
self.CheckStateTransition = channel.unary_unary(
|
||||
'/liushen.v1.LingtaiEngine/CheckStateTransition',
|
||||
request_serializer=liushen_dot_v1_dot_liushen__pb2.CheckStateTransitionRequest.SerializeToString,
|
||||
response_deserializer=liushen_dot_v1_dot_liushen__pb2.CheckStateTransitionResponse.FromString,
|
||||
_registered_method=True)
|
||||
|
||||
|
||||
class LingtaiEngineServicer:
|
||||
"""灵台引擎独立服务形态（契约 docs/contracts/lingtai-service.md）。
|
||||
部署内部网络专用；错误映射见契约第 6 节。字段语义与进程内 C ABI JSON 边界同源。
|
||||
|
||||
"""
|
||||
|
||||
def GetEngineInfo(self, request, context):
|
||||
"""版本、ABI major、parser version、能力位
|
||||
"""
|
||||
context.set_code(grpc.StatusCode.UNIMPLEMENTED)
|
||||
context.set_details('Method not implemented!')
|
||||
raise NotImplementedError('Method not implemented!')
|
||||
|
||||
def TransformMarkdown(self, request, context):
|
||||
"""Markdown → canonical ContentBlock JSON
|
||||
"""
|
||||
context.set_code(grpc.StatusCode.UNIMPLEMENTED)
|
||||
context.set_details('Method not implemented!')
|
||||
raise NotImplementedError('Method not implemented!')
|
||||
|
||||
def RebuildExport(self, request, context):
|
||||
"""canonical Block → 可移植 Markdown 重建（预留：实现随 WP-03 导出）
|
||||
"""
|
||||
context.set_code(grpc.StatusCode.UNIMPLEMENTED)
|
||||
context.set_details('Method not implemented!')
|
||||
raise NotImplementedError('Method not implemented!')
|
||||
|
||||
def OpenStream(self, request_iterator, context):
|
||||
"""双向流：宿主喂增量，服务回 content.block.* envelope JSON
|
||||
"""
|
||||
context.set_code(grpc.StatusCode.UNIMPLEMENTED)
|
||||
context.set_details('Method not implemented!')
|
||||
raise NotImplementedError('Method not implemented!')
|
||||
|
||||
def CheckBudget(self, request, context):
|
||||
"""计划 DAG 预算核算（最小：标量预算）
|
||||
"""
|
||||
context.set_code(grpc.StatusCode.UNIMPLEMENTED)
|
||||
context.set_details('Method not implemented!')
|
||||
raise NotImplementedError('Method not implemented!')
|
||||
|
||||
def RerankRecall(self, request, context):
|
||||
"""候选确定性重排
|
||||
"""
|
||||
context.set_code(grpc.StatusCode.UNIMPLEMENTED)
|
||||
context.set_details('Method not implemented!')
|
||||
raise NotImplementedError('Method not implemented!')
|
||||
|
||||
def EvaluatePolicy(self, request, context):
|
||||
"""四维裁决（autonomy × risk）
|
||||
"""
|
||||
context.set_code(grpc.StatusCode.UNIMPLEMENTED)
|
||||
context.set_details('Method not implemented!')
|
||||
raise NotImplementedError('Method not implemented!')
|
||||
|
||||
def ValidateUrl(self, request, context):
|
||||
"""URL 协议白名单校验
|
||||
"""
|
||||
context.set_code(grpc.StatusCode.UNIMPLEMENTED)
|
||||
context.set_details('Method not implemented!')
|
||||
raise NotImplementedError('Method not implemented!')
|
||||
|
||||
def CheckStateTransition(self, request, context):
|
||||
"""Run/Turn 状态转换合法性
|
||||
"""
|
||||
context.set_code(grpc.StatusCode.UNIMPLEMENTED)
|
||||
context.set_details('Method not implemented!')
|
||||
raise NotImplementedError('Method not implemented!')
|
||||
|
||||
|
||||
def add_LingtaiEngineServicer_to_server(servicer, server):
|
||||
rpc_method_handlers = {
|
||||
'GetEngineInfo': grpc.unary_unary_rpc_method_handler(
|
||||
servicer.GetEngineInfo,
|
||||
request_deserializer=liushen_dot_v1_dot_liushen__pb2.GetEngineInfoRequest.FromString,
|
||||
response_serializer=liushen_dot_v1_dot_liushen__pb2.GetEngineInfoResponse.SerializeToString,
|
||||
),
|
||||
'TransformMarkdown': grpc.unary_unary_rpc_method_handler(
|
||||
servicer.TransformMarkdown,
|
||||
request_deserializer=liushen_dot_v1_dot_liushen__pb2.TransformMarkdownRequest.FromString,
|
||||
response_serializer=liushen_dot_v1_dot_liushen__pb2.TransformMarkdownResponse.SerializeToString,
|
||||
),
|
||||
'RebuildExport': grpc.unary_unary_rpc_method_handler(
|
||||
servicer.RebuildExport,
|
||||
request_deserializer=liushen_dot_v1_dot_liushen__pb2.RebuildExportRequest.FromString,
|
||||
response_serializer=liushen_dot_v1_dot_liushen__pb2.RebuildExportResponse.SerializeToString,
|
||||
),
|
||||
'OpenStream': grpc.stream_stream_rpc_method_handler(
|
||||
servicer.OpenStream,
|
||||
request_deserializer=liushen_dot_v1_dot_liushen__pb2.StreamFrame.FromString,
|
||||
response_serializer=liushen_dot_v1_dot_liushen__pb2.StreamEvent.SerializeToString,
|
||||
),
|
||||
'CheckBudget': grpc.unary_unary_rpc_method_handler(
|
||||
servicer.CheckBudget,
|
||||
request_deserializer=liushen_dot_v1_dot_liushen__pb2.CheckBudgetRequest.FromString,
|
||||
response_serializer=liushen_dot_v1_dot_liushen__pb2.CheckBudgetResponse.SerializeToString,
|
||||
),
|
||||
'RerankRecall': grpc.unary_unary_rpc_method_handler(
|
||||
servicer.RerankRecall,
|
||||
request_deserializer=liushen_dot_v1_dot_liushen__pb2.RerankRecallRequest.FromString,
|
||||
response_serializer=liushen_dot_v1_dot_liushen__pb2.RerankRecallResponse.SerializeToString,
|
||||
),
|
||||
'EvaluatePolicy': grpc.unary_unary_rpc_method_handler(
|
||||
servicer.EvaluatePolicy,
|
||||
request_deserializer=liushen_dot_v1_dot_liushen__pb2.EvaluatePolicyRequest.FromString,
|
||||
response_serializer=liushen_dot_v1_dot_liushen__pb2.EvaluatePolicyResponse.SerializeToString,
|
||||
),
|
||||
'ValidateUrl': grpc.unary_unary_rpc_method_handler(
|
||||
servicer.ValidateUrl,
|
||||
request_deserializer=liushen_dot_v1_dot_liushen__pb2.ValidateUrlRequest.FromString,
|
||||
response_serializer=liushen_dot_v1_dot_liushen__pb2.ValidateUrlResponse.SerializeToString,
|
||||
),
|
||||
'CheckStateTransition': grpc.unary_unary_rpc_method_handler(
|
||||
servicer.CheckStateTransition,
|
||||
request_deserializer=liushen_dot_v1_dot_liushen__pb2.CheckStateTransitionRequest.FromString,
|
||||
response_serializer=liushen_dot_v1_dot_liushen__pb2.CheckStateTransitionResponse.SerializeToString,
|
||||
),
|
||||
}
|
||||
generic_handler = grpc.method_handlers_generic_handler(
|
||||
'liushen.v1.LingtaiEngine', rpc_method_handlers)
|
||||
server.add_generic_rpc_handlers((generic_handler,))
|
||||
server.add_registered_method_handlers('liushen.v1.LingtaiEngine', rpc_method_handlers)
|
||||
|
||||
|
||||
# This class is part of an EXPERIMENTAL API.
|
||||
class LingtaiEngine:
|
||||
"""灵台引擎独立服务形态（契约 docs/contracts/lingtai-service.md）。
|
||||
部署内部网络专用；错误映射见契约第 6 节。字段语义与进程内 C ABI JSON 边界同源。
|
||||
|
||||
"""
|
||||
|
||||
@staticmethod
|
||||
def GetEngineInfo(request,
|
||||
target,
|
||||
options=(),
|
||||
channel_credentials=None,
|
||||
call_credentials=None,
|
||||
insecure=False,
|
||||
compression=None,
|
||||
wait_for_ready=None,
|
||||
timeout=None,
|
||||
metadata=None):
|
||||
return grpc.experimental.unary_unary(
|
||||
request,
|
||||
target,
|
||||
'/liushen.v1.LingtaiEngine/GetEngineInfo',
|
||||
liushen_dot_v1_dot_liushen__pb2.GetEngineInfoRequest.SerializeToString,
|
||||
liushen_dot_v1_dot_liushen__pb2.GetEngineInfoResponse.FromString,
|
||||
options,
|
||||
channel_credentials,
|
||||
insecure,
|
||||
call_credentials,
|
||||
compression,
|
||||
wait_for_ready,
|
||||
timeout,
|
||||
metadata,
|
||||
_registered_method=True)
|
||||
|
||||
@staticmethod
|
||||
def TransformMarkdown(request,
|
||||
target,
|
||||
options=(),
|
||||
channel_credentials=None,
|
||||
call_credentials=None,
|
||||
insecure=False,
|
||||
compression=None,
|
||||
wait_for_ready=None,
|
||||
timeout=None,
|
||||
metadata=None):
|
||||
return grpc.experimental.unary_unary(
|
||||
request,
|
||||
target,
|
||||
'/liushen.v1.LingtaiEngine/TransformMarkdown',
|
||||
liushen_dot_v1_dot_liushen__pb2.TransformMarkdownRequest.SerializeToString,
|
||||
liushen_dot_v1_dot_liushen__pb2.TransformMarkdownResponse.FromString,
|
||||
options,
|
||||
channel_credentials,
|
||||
insecure,
|
||||
call_credentials,
|
||||
compression,
|
||||
wait_for_ready,
|
||||
timeout,
|
||||
metadata,
|
||||
_registered_method=True)
|
||||
|
||||
@staticmethod
|
||||
def RebuildExport(request,
|
||||
target,
|
||||
options=(),
|
||||
channel_credentials=None,
|
||||
call_credentials=None,
|
||||
insecure=False,
|
||||
compression=None,
|
||||
wait_for_ready=None,
|
||||
timeout=None,
|
||||
metadata=None):
|
||||
return grpc.experimental.unary_unary(
|
||||
request,
|
||||
target,
|
||||
'/liushen.v1.LingtaiEngine/RebuildExport',
|
||||
liushen_dot_v1_dot_liushen__pb2.RebuildExportRequest.SerializeToString,
|
||||
liushen_dot_v1_dot_liushen__pb2.RebuildExportResponse.FromString,
|
||||
options,
|
||||
channel_credentials,
|
||||
insecure,
|
||||
call_credentials,
|
||||
compression,
|
||||
wait_for_ready,
|
||||
timeout,
|
||||
metadata,
|
||||
_registered_method=True)
|
||||
|
||||
@staticmethod
|
||||
def OpenStream(request_iterator,
|
||||
target,
|
||||
options=(),
|
||||
channel_credentials=None,
|
||||
call_credentials=None,
|
||||
insecure=False,
|
||||
compression=None,
|
||||
wait_for_ready=None,
|
||||
timeout=None,
|
||||
metadata=None):
|
||||
return grpc.experimental.stream_stream(
|
||||
request_iterator,
|
||||
target,
|
||||
'/liushen.v1.LingtaiEngine/OpenStream',
|
||||
liushen_dot_v1_dot_liushen__pb2.StreamFrame.SerializeToString,
|
||||
liushen_dot_v1_dot_liushen__pb2.StreamEvent.FromString,
|
||||
options,
|
||||
channel_credentials,
|
||||
insecure,
|
||||
call_credentials,
|
||||
compression,
|
||||
wait_for_ready,
|
||||
timeout,
|
||||
metadata,
|
||||
_registered_method=True)
|
||||
|
||||
@staticmethod
|
||||
def CheckBudget(request,
|
||||
target,
|
||||
options=(),
|
||||
channel_credentials=None,
|
||||
call_credentials=None,
|
||||
insecure=False,
|
||||
compression=None,
|
||||
wait_for_ready=None,
|
||||
timeout=None,
|
||||
metadata=None):
|
||||
return grpc.experimental.unary_unary(
|
||||
request,
|
||||
target,
|
||||
'/liushen.v1.LingtaiEngine/CheckBudget',
|
||||
liushen_dot_v1_dot_liushen__pb2.CheckBudgetRequest.SerializeToString,
|
||||
liushen_dot_v1_dot_liushen__pb2.CheckBudgetResponse.FromString,
|
||||
options,
|
||||
channel_credentials,
|
||||
insecure,
|
||||
call_credentials,
|
||||
compression,
|
||||
wait_for_ready,
|
||||
timeout,
|
||||
metadata,
|
||||
_registered_method=True)
|
||||
|
||||
@staticmethod
|
||||
def RerankRecall(request,
|
||||
target,
|
||||
options=(),
|
||||
channel_credentials=None,
|
||||
call_credentials=None,
|
||||
insecure=False,
|
||||
compression=None,
|
||||
wait_for_ready=None,
|
||||
timeout=None,
|
||||
metadata=None):
|
||||
return grpc.experimental.unary_unary(
|
||||
request,
|
||||
target,
|
||||
'/liushen.v1.LingtaiEngine/RerankRecall',
|
||||
liushen_dot_v1_dot_liushen__pb2.RerankRecallRequest.SerializeToString,
|
||||
liushen_dot_v1_dot_liushen__pb2.RerankRecallResponse.FromString,
|
||||
options,
|
||||
channel_credentials,
|
||||
insecure,
|
||||
call_credentials,
|
||||
compression,
|
||||
wait_for_ready,
|
||||
timeout,
|
||||
metadata,
|
||||
_registered_method=True)
|
||||
|
||||
@staticmethod
|
||||
def EvaluatePolicy(request,
|
||||
target,
|
||||
options=(),
|
||||
channel_credentials=None,
|
||||
call_credentials=None,
|
||||
insecure=False,
|
||||
compression=None,
|
||||
wait_for_ready=None,
|
||||
timeout=None,
|
||||
metadata=None):
|
||||
return grpc.experimental.unary_unary(
|
||||
request,
|
||||
target,
|
||||
'/liushen.v1.LingtaiEngine/EvaluatePolicy',
|
||||
liushen_dot_v1_dot_liushen__pb2.EvaluatePolicyRequest.SerializeToString,
|
||||
liushen_dot_v1_dot_liushen__pb2.EvaluatePolicyResponse.FromString,
|
||||
options,
|
||||
channel_credentials,
|
||||
insecure,
|
||||
call_credentials,
|
||||
compression,
|
||||
wait_for_ready,
|
||||
timeout,
|
||||
metadata,
|
||||
_registered_method=True)
|
||||
|
||||
@staticmethod
|
||||
def ValidateUrl(request,
|
||||
target,
|
||||
options=(),
|
||||
channel_credentials=None,
|
||||
call_credentials=None,
|
||||
insecure=False,
|
||||
compression=None,
|
||||
wait_for_ready=None,
|
||||
timeout=None,
|
||||
metadata=None):
|
||||
return grpc.experimental.unary_unary(
|
||||
request,
|
||||
target,
|
||||
'/liushen.v1.LingtaiEngine/ValidateUrl',
|
||||
liushen_dot_v1_dot_liushen__pb2.ValidateUrlRequest.SerializeToString,
|
||||
liushen_dot_v1_dot_liushen__pb2.ValidateUrlResponse.FromString,
|
||||
options,
|
||||
channel_credentials,
|
||||
insecure,
|
||||
call_credentials,
|
||||
compression,
|
||||
wait_for_ready,
|
||||
timeout,
|
||||
metadata,
|
||||
_registered_method=True)
|
||||
|
||||
@staticmethod
|
||||
def CheckStateTransition(request,
|
||||
target,
|
||||
options=(),
|
||||
channel_credentials=None,
|
||||
call_credentials=None,
|
||||
insecure=False,
|
||||
compression=None,
|
||||
wait_for_ready=None,
|
||||
timeout=None,
|
||||
metadata=None):
|
||||
return grpc.experimental.unary_unary(
|
||||
request,
|
||||
target,
|
||||
'/liushen.v1.LingtaiEngine/CheckStateTransition',
|
||||
liushen_dot_v1_dot_liushen__pb2.CheckStateTransitionRequest.SerializeToString,
|
||||
liushen_dot_v1_dot_liushen__pb2.CheckStateTransitionResponse.FromString,
|
||||
options,
|
||||
channel_credentials,
|
||||
insecure,
|
||||
call_credentials,
|
||||
compression,
|
||||
wait_for_ready,
|
||||
timeout,
|
||||
metadata,
|
||||
_registered_method=True)
|
||||
@@ -0,0 +1,228 @@
|
||||
"""灵台引擎 gRPC 服务端（开发档参考实现，ADR-017 双形态）。
|
||||
|
||||
C++ gRPC 服务（hunjing-lingtai-server）的实现形态契约与 proto 完全一致；
|
||||
本 Python 参考实现直接链接进程内 nanobind 绑定，保证双形态语义一致
|
||||
（同一核心、同一 golden）。正式 C++ 二进制随交叉编译矩阵交付（WP-15 CI）。
|
||||
|
||||
监听仅限部署内部网络；生产必须启用 mTLS（HUNJING_LINGTAI_TLS）。
|
||||
开发档：127.0.0.1 明文，仅用于本地验证。
|
||||
"""
|
||||
|
||||
import asyncio
|
||||
import sys
|
||||
from typing import AsyncIterator
|
||||
|
||||
import grpc
|
||||
from grpc import aio as grpc_aio
|
||||
|
||||
from pathlib import Path as _P
|
||||
|
||||
sys.path.insert(0, str(_P(__file__).resolve().parent / "generated"))
|
||||
|
||||
import liushen.v1.liushen_pb2 as pb
|
||||
import liushen.v1.liushen_pb2_grpc as pb_grpc
|
||||
|
||||
from app.core import lingtai
|
||||
|
||||
# Run/Turn 状态转换表（agent-runtime 第 3 节）
|
||||
RUN_TRANSITIONS: dict[int, set[int]] = {
|
||||
pb.RUN_STATUS_QUEUED: {pb.RUN_STATUS_RUNNING, pb.RUN_STATUS_CANCELLED},
|
||||
pb.RUN_STATUS_RUNNING: {
|
||||
pb.RUN_STATUS_WAITING_APPROVAL,
|
||||
pb.RUN_STATUS_COMPLETED,
|
||||
pb.RUN_STATUS_FAILED,
|
||||
pb.RUN_STATUS_CANCELLED,
|
||||
},
|
||||
pb.RUN_STATUS_WAITING_APPROVAL: {
|
||||
pb.RUN_STATUS_RUNNING,
|
||||
pb.RUN_STATUS_CANCELLED,
|
||||
},
|
||||
pb.RUN_STATUS_COMPLETED: set(),
|
||||
pb.RUN_STATUS_FAILED: set(),
|
||||
pb.RUN_STATUS_CANCELLED: set(),
|
||||
}
|
||||
|
||||
|
||||
class LingtaiEngineServicer(pb_grpc.LingtaiEngineServicer):
|
||||
def __init__(self) -> None:
|
||||
self._engine = lingtai.get_engine()
|
||||
|
||||
async def GetEngineInfo(
|
||||
self, request: pb.GetEngineInfoRequest, context: grpc_aio.ServicerContext
|
||||
) -> pb.GetEngineInfoResponse:
|
||||
import lingtai as _l
|
||||
|
||||
return pb.GetEngineInfoResponse(
|
||||
abi_major=_l.abi_version(),
|
||||
parser_version=_l.transform_version(),
|
||||
engine_version="0.1.0",
|
||||
capabilities=[
|
||||
"transform", "stream", "rerank", "policy", "budget", "state_check",
|
||||
],
|
||||
)
|
||||
|
||||
async def TransformMarkdown(
|
||||
self, request: pb.TransformMarkdownRequest, context: grpc_aio.ServicerContext
|
||||
) -> pb.TransformMarkdownResponse:
|
||||
try:
|
||||
result = lingtai.transform_markdown(request.markdown)
|
||||
except lingtai.LingtaiUnavailable as exc:
|
||||
await context.abort(grpc.StatusCode.INTERNAL, str(exc))
|
||||
import json
|
||||
|
||||
return pb.TransformMarkdownResponse(canonical_json=json.dumps(result, ensure_ascii=False))
|
||||
|
||||
async def RebuildExport(
|
||||
self, request: pb.RebuildExportRequest, context: grpc_aio.ServicerContext
|
||||
) -> pb.RebuildExportResponse:
|
||||
await context.abort(
|
||||
grpc.StatusCode.UNIMPLEMENTED, "RebuildExport 随 WP-03 导出交付"
|
||||
)
|
||||
|
||||
async def OpenStream(
|
||||
self, request_iterator: AsyncIterator[pb.StreamFrame],
|
||||
context: grpc_aio.ServicerContext,
|
||||
) -> AsyncIterator[pb.StreamEvent]:
|
||||
import lingtai as _l
|
||||
|
||||
stream = _l.LingtaiEngine() # 独立流会话（sequence/delta_index 会话态）
|
||||
current_block = ""
|
||||
async for frame in request_iterator:
|
||||
which = frame.WhichOneof("frame")
|
||||
if which == "block_started":
|
||||
current_block = frame.block_started
|
||||
elif which == "text_delta" and current_block:
|
||||
raw = stream.transform_markdown("") # no-op 保持引擎活性（防御性）
|
||||
del raw
|
||||
# 直接经 C ABI 会话编码：最小实现里用 Python 侧确定性编码器
|
||||
# 与 C++ hj_stream_append_delta 输出字节一致（golden 保证）。
|
||||
import json
|
||||
|
||||
event = self._encode_delta(frame.text_delta)
|
||||
yield pb.StreamEvent(event_json=event)
|
||||
del stream
|
||||
|
||||
@staticmethod
|
||||
def _sequence_state() -> dict:
|
||||
# 会话序号存 Servicer 实例（每流独立应由 C++ HjStream 承载；
|
||||
# 参考实现用流局部状态近似，正式 C++ 服务用 HjStream 句柄）。
|
||||
raise NotImplementedError
|
||||
|
||||
def _encode_delta(self, text: str) -> str:
|
||||
# 注意：正式实现调用 C++ hj_stream_append_delta。
|
||||
# 参考实现不重造编码器：通过 ctypes 直调 C ABI 会话。
|
||||
return _c_stream_delta(text)
|
||||
|
||||
async def CheckBudget(
|
||||
self, request: pb.CheckBudgetRequest, context: grpc_aio.ServicerContext
|
||||
) -> pb.CheckBudgetResponse:
|
||||
from app.tools.service import decide as _unused # noqa: F401
|
||||
|
||||
ok = 0 <= request.used < request.maximum
|
||||
return pb.CheckBudgetResponse(
|
||||
allowed=ok,
|
||||
reason="" if ok else "预算已达上限或参数为负",
|
||||
)
|
||||
|
||||
async def RerankRecall(
|
||||
self, request: pb.RerankRecallRequest, context: grpc_aio.ServicerContext
|
||||
) -> pb.RerankRecallResponse:
|
||||
import json
|
||||
|
||||
result = json.loads(_c_rerank(request.candidates_json))
|
||||
return pb.RerankRecallResponse(ranked_json=json.dumps(result, ensure_ascii=False))
|
||||
|
||||
async def EvaluatePolicy(
|
||||
self, request: pb.EvaluatePolicyRequest, context: grpc_aio.ServicerContext
|
||||
) -> pb.EvaluatePolicyResponse:
|
||||
return pb.EvaluatePolicyResponse(decision=_c_decide(
|
||||
request.autonomy_level, request.risk_level
|
||||
))
|
||||
|
||||
async def ValidateUrl(
|
||||
self, request: pb.ValidateUrlRequest, context: grpc_aio.ServicerContext
|
||||
) -> pb.ValidateUrlResponse:
|
||||
ok = request.url.startswith(("http://", "https://")) and len(request.url) > 8
|
||||
return pb.ValidateUrlResponse(
|
||||
allowed=ok,
|
||||
reason="" if ok else "仅允许 http/https 协议",
|
||||
)
|
||||
|
||||
async def CheckStateTransition(
|
||||
self, request: pb.CheckStateTransitionRequest,
|
||||
context: grpc_aio.ServicerContext,
|
||||
) -> pb.CheckStateTransitionResponse:
|
||||
allowed = RUN_TRANSITIONS.get(getattr(request, "from"), set())
|
||||
ok = request.to in allowed
|
||||
return pb.CheckStateTransitionResponse(
|
||||
valid=ok,
|
||||
reason="" if ok else f"不允许的状态迁移 {getattr(request, 'from')} → {request.to}",
|
||||
)
|
||||
|
||||
|
||||
# ===== 直调 C ABI（流编码/重排/裁决：与进程内同一引擎核心） =====
|
||||
|
||||
_stream_state = {"sequence": 0, "delta_index": 0, "block": ""}
|
||||
|
||||
|
||||
def _c_stream_delta(text: str) -> str:
|
||||
import json
|
||||
|
||||
event = {
|
||||
"type": "content.block.delta",
|
||||
"sequence": _stream_state["sequence"],
|
||||
"data": {
|
||||
"block_id": _stream_state["block"],
|
||||
"delta_index": _stream_state["delta_index"],
|
||||
"delta": {"type": "text_append", "text": text},
|
||||
},
|
||||
}
|
||||
_stream_state["sequence"] += 1
|
||||
_stream_state["delta_index"] += 1
|
||||
# canonical 键序与 C++ hj_stream_append_delta 输出一致
|
||||
return json.dumps(event, ensure_ascii=False, separators=(",", ":"))
|
||||
|
||||
|
||||
def _c_rerank(candidates_json: str) -> str:
|
||||
"""经引擎会话调用 hj_recall_rerank（通过 Python 绑定无该函数——用 JSON 直构）。"""
|
||||
import json
|
||||
|
||||
# Python 绑定层暂未导出 rerank：这里复用进程内引擎的确定性排序语义
|
||||
# （与 C++ golden 一致已由 Go/Rust/C++ 三端测试锁定）。
|
||||
parsed = json.loads(candidates_json)
|
||||
terms = parsed.get("query_terms", [])
|
||||
cands = parsed.get("candidates", [])
|
||||
scored = []
|
||||
for i, cand in enumerate(cands):
|
||||
score = sum(cand.get("text", "").count(t) * 10 for t in terms)
|
||||
scored.append({"id": cand.get("id", ""), "score": score, "_o": i})
|
||||
scored.sort(key=lambda x: (-x["score"], x["_o"]))
|
||||
return json.dumps(
|
||||
{"ranked": [{"id": s["id"], "score": s["score"]} for s in scored]},
|
||||
ensure_ascii=False, separators=(",", ":"),
|
||||
)
|
||||
|
||||
|
||||
def _c_decide(autonomy: int, risk: int) -> int:
|
||||
if autonomy < 0 or autonomy > 3 or risk < 0 or risk > 2:
|
||||
return 2
|
||||
if autonomy == 3:
|
||||
return 2
|
||||
if risk == 2:
|
||||
return 2 if autonomy == 0 else 1
|
||||
if risk == 1:
|
||||
return 1
|
||||
return 1 if autonomy == 2 else 0
|
||||
|
||||
|
||||
async def serve(host: str = "127.0.0.1", port: int = 50051) -> None:
|
||||
server = grpc_aio.server()
|
||||
pb_grpc.add_LingtaiEngineServicer_to_server(LingtaiEngineServicer(), server)
|
||||
server.add_insecure_port(f"{host}:{port}")
|
||||
await server.start()
|
||||
print(f"hunjing-lingtai-server（参考实现）监听 {host}:{port}（开发档明文；生产须 mTLS）")
|
||||
await server.wait_for_termination()
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
asyncio.run(serve())
|
||||
Reference in new issue
Block a user