flare-kernel 0.1.0__tar.gz → 0.2.0__tar.gz

{flare_kernel-0.1.0 → flare_kernel-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flare-kernel
-Version: 0.1.0
+Version: 0.2.0
 Summary: FLARE kernel runtime package
 License: Proprietary
 Classifier: Development Status :: 3 - Alpha
@@ -8,10 +8,15 @@ 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: flare-engines<0.3.0,>=0.2.0
 Requires-Dist: fastapi<1.0,>=0.115
 Requires-Dist: pydantic<3,>=2
 Requires-Dist: uvicorn<1.0,>=0.30
+Requires-Dist: httpx<1.0,>=0.27
+Requires-Dist: sqlalchemy<3,>=2
+Requires-Dist: psycopg2-binary<3,>=2.9
+Requires-Dist: redis<6,>=5
+Requires-Dist: qdrant-client<2,>=1.9
 
 # flare-kernel
 
@@ -37,21 +42,22 @@ Requires-Dist: uvicorn<1.0,>=0.30
 1. `POST /kernel/run`
 2. `POST /kernel/stream`
 3. `GET /kernel/health`
+4. `POST /kernel/knowledge/ingest`
+5. `POST /kernel/knowledge/search`
 
 kernel 现已输出 mode/context 运行时占位事件与字段。
 
-## Instance 注入（品牌信息）
+## 品牌注入（可选）
 
-1. kernel 支持从 instance 的 domain-pack 读取品牌配置：
+1. kernel 支持从 domain-pack 读取品牌配置：
    `branding/instance-branding.json`
-2. 读取优先级：
-   - 环境变量 `FLARE_DOMAIN_PACK_ROOT`
-   - 自动探测 `apps/<instance_id>/domain-pack`
+2. 读取方式：
+   - 仅通过环境变量 `FLARE_DOMAIN_PACK_ROOT` 显式指定
 3. 注入位置：
    - `POST /kernel/run` 响应 `result.instance_profile`
    - `POST /kernel/stream` SSE 事件 `instance_profile`
 
-说明：品牌注入仅在 instance 层配置，core 不写死产品名、logo、标签。
+说明：品牌注入通过外部 domain-pack 配置，core 不写死产品名、logo、标签。
 
 本地启动（示例）：
 
@@ -59,6 +65,29 @@ kernel 现已输出 mode/context 运行时占位事件与字段。
 uvicorn flare_kernel.main:app --app-dir packages/flare-kernel/src --host 0.0.0.0 --port 8002
 ```
 
+环境变量（真实链路）：
+
+1. `DASHSCOPE_API_KEY`（必填，真实百炼调用）
+2. `LLM_PROVIDER_BACKEND`（默认 `dashscope`）
+3. `FLARE_POSTGRES_DSN`
+4. `FLARE_REDIS_URL`
+5. `FLARE_QDRANT_URL`
+
+健康检查会输出依赖状态：
+
+1. `llm_ready`
+2. `postgres_ready`
+3. `redis_ready`
+4. `qdrant_ready`
+
+模式决策优先级（`/kernel/run` 与 `/kernel/stream`）：
+
+1. `intent_override`（外部业务侧注入）
+2. 消息意图识别（内置关键词）
+3. `manual_mode`
+4. `current_mode`
+5. fallback（`intent/default`）
+
 ## 最小发布说明
 
 1. 当前包版本：`0.1.0`

{flare_kernel-0.1.0 → flare_kernel-0.2.0}/README.md

@@ -22,21 +22,22 @@
 1. `POST /kernel/run`
 2. `POST /kernel/stream`
 3. `GET /kernel/health`
+4. `POST /kernel/knowledge/ingest`
+5. `POST /kernel/knowledge/search`
 
 kernel 现已输出 mode/context 运行时占位事件与字段。
 
-## Instance 注入（品牌信息）
+## 品牌注入（可选）
 
-1. kernel 支持从 instance 的 domain-pack 读取品牌配置：
+1. kernel 支持从 domain-pack 读取品牌配置：
    `branding/instance-branding.json`
-2. 读取优先级：
-   - 环境变量 `FLARE_DOMAIN_PACK_ROOT`
-   - 自动探测 `apps/<instance_id>/domain-pack`
+2. 读取方式：
+   - 仅通过环境变量 `FLARE_DOMAIN_PACK_ROOT` 显式指定
 3. 注入位置：
    - `POST /kernel/run` 响应 `result.instance_profile`
    - `POST /kernel/stream` SSE 事件 `instance_profile`
 
-说明：品牌注入仅在 instance 层配置，core 不写死产品名、logo、标签。
+说明：品牌注入通过外部 domain-pack 配置，core 不写死产品名、logo、标签。
 
 本地启动（示例）：
 
@@ -44,6 +45,29 @@ kernel 现已输出 mode/context 运行时占位事件与字段。
 uvicorn flare_kernel.main:app --app-dir packages/flare-kernel/src --host 0.0.0.0 --port 8002
 ```
 
+环境变量（真实链路）：
+
+1. `DASHSCOPE_API_KEY`（必填，真实百炼调用）
+2. `LLM_PROVIDER_BACKEND`（默认 `dashscope`）
+3. `FLARE_POSTGRES_DSN`
+4. `FLARE_REDIS_URL`
+5. `FLARE_QDRANT_URL`
+
+健康检查会输出依赖状态：
+
+1. `llm_ready`
+2. `postgres_ready`
+3. `redis_ready`
+4. `qdrant_ready`
+
+模式决策优先级（`/kernel/run` 与 `/kernel/stream`）：
+
+1. `intent_override`（外部业务侧注入）
+2. 消息意图识别（内置关键词）
+3. `manual_mode`
+4. `current_mode`
+5. fallback（`intent/default`）
+
 ## 最小发布说明
 
 1. 当前包版本：`0.1.0`

{flare_kernel-0.1.0 → flare_kernel-0.2.0}/pyproject.toml

@@ -4,15 +4,20 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "flare-kernel"
-version = "0.1.0"
+version = "0.2.0"
 description = "FLARE kernel runtime package"
 readme = "README.md"
 requires-python = ">=3.11"
 dependencies = [
-    "flare-engines>=0.1.0,<0.2.0",
+    "flare-engines>=0.2.0,<0.3.0",
     "fastapi>=0.115,<1.0",
     "pydantic>=2,<3",
     "uvicorn>=0.30,<1.0",
+    "httpx>=0.27,<1.0",
+    "sqlalchemy>=2,<3",
+    "psycopg2-binary>=2.9,<3",
+    "redis>=5,<6",
+    "qdrant-client>=1.9,<2",
 ]
 license = { text = "Proprietary" }
 classifiers = [

flare_kernel-0.2.0/src/flare_kernel/contracts/__init__.py

@@ -0,0 +1,23 @@
+"""Kernel contracts."""
+
+from flare_kernel.contracts.kernel_contract import (
+    HealthResponse,
+    IntentSuggestResponse,
+    KernelRequest,
+    KernelResponse,
+    KnowledgeIngestRequest,
+    KnowledgeIngestResponse,
+    KnowledgeSearchRequest,
+    KnowledgeSearchResponse,
+)
+
+__all__ = [
+    "KernelRequest",
+    "KernelResponse",
+    "HealthResponse",
+    "IntentSuggestResponse",
+    "KnowledgeIngestRequest",
+    "KnowledgeIngestResponse",
+    "KnowledgeSearchRequest",
+    "KnowledgeSearchResponse",
+]

flare_kernel-0.2.0/src/flare_kernel/contracts/kernel_contract.py

@@ -0,0 +1,96 @@
+"""Kernel API contracts."""
+
+from __future__ import annotations
+
+from typing import Any, Literal
+
+from pydantic import BaseModel, Field
+
+
+class KernelRequest(BaseModel):
+    tenant_id: str = "default"
+    instance_id: str = "default"
+    domain_pack_version: str = "v1"
+    session_id: str = "default"
+    intent: str = "default"
+    intent_override: str | None = None
+    mode: str | None = None
+    manual_mode: str | None = None
+    current_mode: str | None = None
+    project_id: str | None = None
+    user_id: str | None = None
+    retrieval_config: dict[str, Any] = Field(default_factory=dict)
+    canvas_config: dict[str, Any] = Field(default_factory=dict)
+    plan_config: dict[str, Any] = Field(default_factory=dict)
+    payload: dict[str, Any] = Field(default_factory=dict)
+    context_refs: list[Any] = Field(default_factory=list)
+    knowledge_refs: list[str] = Field(default_factory=list)
+    action_key: str | None = None
+    target_mode: str | None = None
+    action_status: str | None = None
+    action_reason: str | None = None
+    trace_id: str | None = None
+
+
+class KernelResponse(BaseModel):
+    trace_id: str
+    state: Literal["RUNNING", "SUCCEEDED", "FAILED"]
+    events: list[dict[str, Any]] = Field(default_factory=list)
+    result: dict[str, Any] = Field(default_factory=dict)
+    next_actions: list[dict[str, Any]] = Field(default_factory=list)
+
+
+class HealthResponse(BaseModel):
+    status: Literal["healthy"]
+    service: str
+    trace_id: str
+    llm_ready: bool
+    postgres_ready: bool
+    redis_ready: bool
+    qdrant_ready: bool
+    canvas_ready: bool
+    rag_ready: bool
+    plan_ready: bool
+
+
+class KnowledgeIngestRequest(BaseModel):
+    project_id: str = "default"
+    user_id: str = "default"
+    session_id: str = "default"
+    source_id: str | None = None
+    title: str | None = None
+    content: str
+    metadata: dict[str, Any] = Field(default_factory=dict)
+
+
+class KnowledgeIngestResponse(BaseModel):
+    trace_id: str
+    project_id: str
+    user_id: str
+    record_id: str
+    chunk_count: int
+    status: Literal["stored", "partial", "failed"]
+    details: dict[str, Any] = Field(default_factory=dict)
+
+
+class KnowledgeSearchRequest(BaseModel):
+    project_id: str = "default"
+    user_id: str = "default"
+    query: str
+    top_k: int = 5
+
+
+class KnowledgeSearchResponse(BaseModel):
+    trace_id: str
+    project_id: str
+    user_id: str
+    query: str
+    results: list[dict[str, Any]] = Field(default_factory=list)
+
+
+class IntentSuggestResponse(BaseModel):
+    trace_id: str
+    suggested_mode: str
+    confidence: float = 0.0
+    reason: str = ""
+    source: Literal["intent_override", "manual", "current", "llm", "keywords", "fallback"] = "fallback"