flare-kernel 0.1.0__py3-none-any.whl

flare_kernel/runtime/tests/test_kernel_runtime.py

@@ -0,0 +1,114 @@
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+_RUNTIME_TESTS_DIR = Path(__file__).resolve().parent
+_KERNEL_SRC = _RUNTIME_TESTS_DIR.parents[2]
+_PACKAGES_DIR = _RUNTIME_TESTS_DIR.parents[4]
+_ENGINES_SRC = _PACKAGES_DIR / "flare-engines" / "src"
+
+for path in (str(_KERNEL_SRC), str(_ENGINES_SRC)):
+    if path not in sys.path:
+        sys.path.insert(0, path)
+
+from flare_kernel.runtime.mode_runtime import build_kernel_runtime
+
+
+def test_build_kernel_runtime_requirement_canvas_exposes_next_actions() -> None:
+    runtime_snapshot = build_kernel_runtime(
+        trace_id="trace-rc",
+        tenant_id="tenant-1",
+        instance_id="instance-1",
+        domain_pack_version="v1",
+        session_id="session-1",
+        intent="requirement_canvas",
+        payload={
+            "function_type": "requirement_canvas",
+            "message": "采购需求：需要3家供应商",
+        },
+        instance_profile=None,
+    )
+
+    assert runtime_snapshot["mode_runtime"] == {
+        "mode_key": "requirement_canvas",
+        "mode_state": "collecting",
+    }
+    assert runtime_snapshot["mode_key"] == "requirement_canvas"
+    assert runtime_snapshot["mode_state"] == "collecting"
+    assert [event["event_type"] for event in runtime_snapshot["mode_events"]] == [
+        "field_progress",
+        "requirement_draft",
+        "next_actions",
+    ]
+    assert runtime_snapshot["next_actions"] == [
+        {
+            "action_key": "continue_collection",
+            "label": "继续梳理",
+            "target_mode": "requirement_canvas",
+            "priority": 1,
+            "status": "blocked",
+            "reason": "字段已完整，当前可以直接进入下一步。",
+            "description": "继续补齐字段，提升需求结构化完整度。",
+        },
+        {
+            "action_key": "handoff_to_sourcing",
+            "label": "进入智能寻源",
+            "target_mode": "intelligent_sourcing",
+            "priority": 2,
+            "status": "available",
+            "reason": "必填字段已补齐，可以进入智能寻源。",
+            "description": "在必填字段完整后切换到候选匹配与风险摘要。",
+        },
+    ]
+    assert runtime_snapshot["agent_runtime"]["mode_key"] == "requirement_canvas"
+    assert runtime_snapshot["skill_runtime"]["mode_key"] == "requirement_canvas"
+    assert runtime_snapshot["context_usage"]["mode_key"] == "requirement_canvas"
+
+
+def test_build_kernel_runtime_intelligent_sourcing_infers_report_ready() -> None:
+    runtime_snapshot = build_kernel_runtime(
+        trace_id="trace-is",
+        tenant_id="tenant-1",
+        instance_id="instance-1",
+        domain_pack_version="v1",
+        session_id="session-1",
+        intent="intelligent_sourcing",
+        payload={
+            "function_type": "intelligent_sourcing",
+            "message": "筛选供应商候选",
+            "base_fields": {
+                "category": {"value": "电子元件"},
+                "region": {"value": "华东"},
+            },
+            "report": {
+                "title": "评估报告",
+                "sections": [
+                    {
+                        "section_key": "overview",
+                        "title": "概览",
+                        "content": "已完成",
+                    }
+                ],
+            },
+        },
+        instance_profile=None,
+    )
+
+    assert runtime_snapshot["mode_runtime"] == {
+        "mode_key": "intelligent_sourcing",
+        "mode_state": "collecting",
+    }
+    assert runtime_snapshot["mode_key"] == "intelligent_sourcing"
+    assert runtime_snapshot["mode_state"] == "report_ready"
+    assert [event["event_type"] for event in runtime_snapshot["mode_events"]] == [
+        "sourcing_candidates",
+        "risk_summary",
+        "shortlist_updated",
+        "evaluation_report_ready",
+    ]
+    assert runtime_snapshot["mode_events"][-1]["payload"]["mode_state"] == "report_ready"
+    assert runtime_snapshot["next_actions"] == []
+    assert runtime_snapshot["agent_runtime"]["mode_key"] == "intelligent_sourcing"
+    assert runtime_snapshot["skill_runtime"]["mode_key"] == "intelligent_sourcing"
+    assert runtime_snapshot["context_usage"]["mode_key"] == "intelligent_sourcing"

flare_kernel/runtime/trace.py

@@ -0,0 +1,11 @@
+"""trace_id helpers."""
+
+from __future__ import annotations
+
+from uuid import uuid4
+
+
+def resolve_trace_id(trace_id: str | None) -> str:
+    if trace_id and trace_id.strip():
+        return trace_id.strip()
+    return uuid4().hex

flare_kernel-0.1.0.dist-info/METADATA

@@ -0,0 +1,67 @@
+Metadata-Version: 2.4
+Name: flare-kernel
+Version: 0.1.0
+Summary: FLARE kernel runtime package
+License: Proprietary
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: flare-engines<0.2.0,>=0.1.0
+Requires-Dist: fastapi<1.0,>=0.115
+Requires-Dist: pydantic<3,>=2
+Requires-Dist: uvicorn<1.0,>=0.30
+
+# flare-kernel
+
+通用编排与执行内核。
+
+职责：
+
+1. Decision 路由与策略入口。
+2. Execution 流程推进与状态管理。
+3. Runtime（含重试、超时、追踪）。
+4. 加载 domain pack 并执行。
+
+## Day 2 最小骨架
+
+目录：
+
+1. `src/flare_kernel/router`：接口路由
+2. `src/flare_kernel/runtime`：`trace_id` 与基础日志
+3. `src/flare_kernel/contracts`：请求/响应契约
+
+最小接口：
+
+1. `POST /kernel/run`
+2. `POST /kernel/stream`
+3. `GET /kernel/health`
+
+kernel 现已输出 mode/context 运行时占位事件与字段。
+
+## Instance 注入（品牌信息）
+
+1. kernel 支持从 instance 的 domain-pack 读取品牌配置：
+   `branding/instance-branding.json`
+2. 读取优先级：
+   - 环境变量 `FLARE_DOMAIN_PACK_ROOT`
+   - 自动探测 `apps/<instance_id>/domain-pack`
+3. 注入位置：
+   - `POST /kernel/run` 响应 `result.instance_profile`
+   - `POST /kernel/stream` SSE 事件 `instance_profile`
+
+说明：品牌注入仅在 instance 层配置，core 不写死产品名、logo、标签。
+
+本地启动（示例）：
+
+```bash
+uvicorn flare_kernel.main:app --app-dir packages/flare-kernel/src --host 0.0.0.0 --port 8002
+```
+
+## 最小发布说明
+
+1. 当前包版本：`0.1.0`
+2. 发布元数据：`packages/flare-kernel/pyproject.toml`
+3. 本地构建：`python -m build`
+4. 本地安装：`pip install packages/flare-kernel`

flare_kernel-0.1.0.dist-info/RECORD

@@ -0,0 +1,21 @@
+flare_kernel/__init__.py,sha256=X2cn_jfyNHfrTi2XMm57dCdvnGtVLkzYAqByLVrHGJA,159
+flare_kernel/app.py,sha256=Qy0mArv68_QnETVsee7vr6q6ZkjnGU-bq8GLN9tRYzI,598
+flare_kernel/main.py,sha256=ZltPDNhgrlyE7znjk5y_nq_WSs-BJCocxRRyDB8vJLQ,84
+flare_kernel/contracts/__init__.py,sha256=KsogV5ClgGeXY4e9buF2IUNBWSRuBVspHjQwGjpVRVE,187
+flare_kernel/contracts/kernel_contract.py,sha256=dVLZTBhcfnKze1wBA77Uybu4zEUQ-BKaV7wxq7YUEf4,1026
+flare_kernel/router/__init__.py,sha256=HAFYy4lcZdzLXDfeU2mJuV72QVCYExOm6KDLc_naBbI,115
+flare_kernel/router/kernel.py,sha256=cn6Pmv1gpx3Mqv4XhT2w8dZ9Ryt7qQ4uVlNyayF-TjA,13197
+flare_kernel/runtime/__init__.py,sha256=U_iY2XXZ-PjvEiJ9i1rBKC-So1fA0NeR_AfxKfenHmU,1060
+flare_kernel/runtime/agent_runtime.py,sha256=QfmZK0JYkmwiXGGX2QNCwYj76Wssne-TP-q7SpEw6f4,3949
+flare_kernel/runtime/domain_pack_loader.py,sha256=GO3_BRi0cVE7o4mgrIBTtc-LaNHUYsuQgXYZKU8-1r8,7549
+flare_kernel/runtime/llm_provider.py,sha256=QG--XUjdixXhy1RXvwdSQv9q1TI2szw2soKf1uBoI-k,7513
+flare_kernel/runtime/logging.py,sha256=0zQIVBfKv6ybKZxfZM-T0gBJmuempX2U9PQmDd9NkOo,458
+flare_kernel/runtime/mode_orchestration.py,sha256=Ur79By21DUrsXptwtHAFfvmqeEDqsSIGWxZkuDM7ALk,12540
+flare_kernel/runtime/mode_runtime.py,sha256=Z2US3p1OuKGsKYrbmEeCdyuTzObkYQaGbxMugLRFMGs,8339
+flare_kernel/runtime/skill_runtime.py,sha256=SYZCpHMoslbjIW47TIGzxVZRVDMojZSqdlZkKyFOTbY,3444
+flare_kernel/runtime/trace.py,sha256=HzyvPNBcDvbWV5egExvbCMp3yOEhIB2yyf7lrSWlqCE,230
+flare_kernel/runtime/tests/test_kernel_runtime.py,sha256=QkRtnvhLvQZVlzqGH0X1tnvsrTLnmEqBVaTJgItCgMc,4269
+flare_kernel-0.1.0.dist-info/METADATA,sha256=j9dOYQOf-tPMpr8ECHtaRaDODf-mOoCONGGfa2m0reE,1859
+flare_kernel-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+flare_kernel-0.1.0.dist-info/top_level.txt,sha256=cCpzWBwMKe6P14l5gAkOZujVeUrk_hVLI4ppzpcKgF8,13
+flare_kernel-0.1.0.dist-info/RECORD,,

flare_kernel-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

flare_kernel-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+flare_kernel