flare-kernel 0.2.13__tar.gz → 0.2.14__tar.gz

{flare_kernel-0.2.13 → flare_kernel-0.2.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flare-kernel
-Version: 0.2.13
+Version: 0.2.14
 Summary: FLARE kernel runtime package
 License: Proprietary
 Classifier: Development Status :: 3 - Alpha

{flare_kernel-0.2.13 → flare_kernel-0.2.14}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "flare-kernel"
-version = "0.2.13"
+version = "0.2.14"
 description = "FLARE kernel runtime package"
 readme = "README.md"
 requires-python = ">=3.11"

{flare_kernel-0.2.13 → flare_kernel-0.2.14}/src/flare_kernel/router/streaming/draft/finalize.py

@@ -14,6 +14,9 @@ from __future__ import annotations
 from typing import Any
 
 from flare_kernel.runtime.llm.llm_provider import LLMCompletion
+from flare_kernel.runtime.orchestration.mode.canvas_state import (
+    build_analysis_canvas_signal_state,
+)
 from flare_kernel.router.completion.analysis_policy import (
     apply_analysis_completion_policy,
 )
@@ -106,6 +109,15 @@ def iter_canonical_finalize_events(
             )
         )
         events.append(emitter.emit_patch("analysis.canvas_payload", analysis_payload))
+        events.append(
+            emitter.emit_event(
+                "canvas_state",
+                build_analysis_canvas_signal_state(
+                    session_id=session_id,
+                    project_id=str(canonical.get("project_id") or ""),
+                ),
+            )
+        )
     slot_patches = canonical.get("analysis_slot_patches")
     if isinstance(slot_patches, list) and slot_patches:
         events.append(emitter.emit_event("analysis_slot_patch", {"patches": slot_patches}))

{flare_kernel-0.2.13 → flare_kernel-0.2.14}/src/flare_kernel/router/streaming/draft/phase.py

@@ -94,7 +94,9 @@ async def iter_draft_generation_events(
             trace_id=trace_id,
             session_id=session_id,
             request_id=request_id,
+            project_id=project_id,
             resolved_mode=resolved_mode,
+            effective_command=effective_command,
             emitter=emitter,
             build_llm_execution_trace_fn=build_llm_execution_trace_fn,
         ):

{flare_kernel-0.2.13 → flare_kernel-0.2.14}/src/flare_kernel/router/streaming/draft/prologue.py

@@ -5,6 +5,9 @@ from __future__ import annotations
 from typing import Any, Callable
 
 from flare_kernel.contracts import KernelRequest
+from flare_kernel.runtime.orchestration.mode.canvas_state import (
+    build_analysis_canvas_signal_state,
+)
 from flare_kernel.router.streaming.event_emitter import StreamingEventEmitter
 
 
@@ -15,6 +18,8 @@ def build_draft_prologue_events(
     session_id: str,
     request_id: str,
     resolved_mode: str,
+    project_id: str = "",
+    effective_command: str = "",
     emitter: StreamingEventEmitter,
     build_llm_execution_trace_fn: Callable[..., dict[str, Any]],
 ) -> list[str]:
@@ -41,6 +46,16 @@ def build_draft_prologue_events(
             },
         )
     )
+    if str(effective_command or "").strip() == "generate_analysis":
+        events.append(
+            emitter.emit_event(
+                "canvas_state",
+                build_analysis_canvas_signal_state(
+                    session_id=session_id,
+                    project_id=project_id,
+                ),
+            )
+        )
     llm_start_trace = build_llm_execution_trace_fn(
         trace_id=trace_id,
         session_id=req.session_id,

{flare_kernel-0.2.13 → flare_kernel-0.2.14}/src/flare_kernel/runtime/orchestration/mode/canvas_state.py

@@ -110,4 +110,31 @@ def _build_canvas_revision_payload(
     }
 
 
-__all__ = ["_build_canvas_revision_payload", "_build_canvas_state_payload"]
+def build_analysis_canvas_signal_state(*, session_id: str, project_id: str = "") -> dict[str, Any]:
+    return {
+        "mode_key": "analysis_mode",
+        "session_id": session_id,
+        "project_id": project_id,
+        "render_hint": "canvas_state",
+        "canvas_state": {
+            "version": 1,
+            "confirmed": True,
+            "progress": 1.0,
+            "collected": [],
+            "missing": [],
+            "revision_suggestions": [],
+            "versions": [],
+        },
+        "ui_signal": {
+            "open_canvas_panel": True,
+            "active_tab": "analysis",
+            "reason": "analysis_payload_ready",
+        },
+    }
+
+
+__all__ = [
+    "_build_canvas_revision_payload",
+    "_build_canvas_state_payload",
+    "build_analysis_canvas_signal_state",
+]

{flare_kernel-0.2.13 → flare_kernel-0.2.14}/src/flare_kernel.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flare-kernel
-Version: 0.2.13
+Version: 0.2.14
 Summary: FLARE kernel runtime package
 License: Proprietary
 Classifier: Development Status :: 3 - Alpha

{flare_kernel-0.2.13 → flare_kernel-0.2.14}/tests/test_streaming_draft_finalize.py

@@ -54,6 +54,7 @@ def test_iter_canonical_finalize_events_emits_done_complete_and_patch_event() ->
         content_text="hello",
         canonical={
             "mode_key": "requirement_intake",
+            "project_id": "project-1",
             "mode_state": "collecting",
             "assistant_reply": {"text": "hello"},
             "primary_flow": {},
@@ -78,12 +79,22 @@ def test_iter_canonical_finalize_events_emits_done_complete_and_patch_event() ->
     names = [_event_name(event) for event in events]
     assert "patch" in names
     assert "analysis_payload" in names
+    assert "canvas_state" in names
     assert "analysis_slot_patch" in names
     assert "patch_event" in names
     assert names[-2:] == ["done", "complete"]
     analysis_event = _event_payload(next(event for event in events if _event_name(event) == "analysis_payload"))
     assert analysis_event["canvas_analysis_payload"] == {"markdown": "# 需求分析"}
     assert analysis_event["analysis_payload"] == {"markdown": "# 需求分析"}
+    canvas_event = _event_payload(next(event for event in events if _event_name(event) == "canvas_state"))
+    assert canvas_event["mode_key"] == "analysis_mode"
+    assert canvas_event["project_id"] == "project-1"
+    assert canvas_event["canvas_state"]["versions"] == []
+    assert canvas_event["ui_signal"] == {
+        "open_canvas_panel": True,
+        "active_tab": "analysis",
+        "reason": "analysis_payload_ready",
+    }
 
     final_patch = _event_payload(next(event for event in events if _event_name(event) == "patch_event"))
     assert final_patch["payload"]["mode_key"] == "requirement_intake"

flare_kernel-0.2.14/tests/test_streaming_draft_prologue.py

@@ -0,0 +1,94 @@
+from __future__ import annotations
+
+import json
+
+from flare_kernel.contracts import KernelRequest
+from flare_kernel.router.streaming.draft.prologue import build_draft_prologue_events
+from flare_kernel.router.streaming.event_emitter import StreamingEventEmitter
+
+
+def _build_emitter() -> StreamingEventEmitter:
+    return StreamingEventEmitter(
+        req=KernelRequest(client_request_id="client-1", last_turn_id="turn-1"),
+        trace_id="trace-1",
+        session_id="session-1",
+        request_id="request-1",
+        patch_scopes={"analysis", "errors", "session", "assistant_reply"},
+        build_patch_event_fn=lambda **kwargs: {"event_type": kwargs["event_type"], "payload": kwargs["payload"]},
+        safe_session_id_fn=lambda value: str(value),
+    )
+
+
+def _event_name(event_text: str) -> str:
+    return event_text.split("\n", 1)[0].replace("event: ", "", 1)
+
+
+def _event_payload(event_text: str) -> dict:
+    line = event_text.split("\n")[1]
+    return json.loads(line.replace("data: ", "", 1))
+
+
+def test_build_draft_prologue_events_emits_bootstrap_sequence() -> None:
+    emitter = _build_emitter()
+
+    events = build_draft_prologue_events(
+        req=KernelRequest(session_id="session-1"),
+        trace_id="trace-1",
+        session_id="session-1",
+        request_id="request-1",
+        resolved_mode="requirement_intake",
+        emitter=emitter,
+        build_llm_execution_trace_fn=lambda **kwargs: {"status": kwargs["status"], "mode_key": kwargs["mode_key"]},
+    )
+
+    assert [_event_name(event) for event in events] == ["phase.start", "heartbeat", "execution_trace"]
+    assert _event_payload(events[-1])["status"] == "running"
+
+
+def test_build_draft_prologue_events_opens_analysis_canvas_for_analysis_generation() -> None:
+    emitter = _build_emitter()
+
+    events = build_draft_prologue_events(
+        req=KernelRequest(session_id="session-1"),
+        trace_id="trace-1",
+        session_id="session-1",
+        request_id="request-1",
+        project_id="project-1",
+        resolved_mode="analysis_mode",
+        effective_command="generate_analysis",
+        emitter=emitter,
+        build_llm_execution_trace_fn=lambda **kwargs: {"status": kwargs["status"], "mode_key": kwargs["mode_key"]},
+    )
+
+    assert [_event_name(event) for event in events] == [
+        "phase.start",
+        "heartbeat",
+        "canvas_state",
+        "execution_trace",
+    ]
+    canvas_event = _event_payload(events[2])
+    assert canvas_event["mode_key"] == "analysis_mode"
+    assert canvas_event["project_id"] == "project-1"
+    assert canvas_event["ui_signal"] == {
+        "open_canvas_panel": True,
+        "active_tab": "analysis",
+        "reason": "analysis_payload_ready",
+    }
+
+
+def test_build_draft_prologue_events_does_not_open_analysis_canvas_for_plain_analysis_mode() -> None:
+    emitter = _build_emitter()
+
+    events = build_draft_prologue_events(
+        req=KernelRequest(session_id="session-1"),
+        trace_id="trace-1",
+        session_id="session-1",
+        request_id="request-1",
+        project_id="project-1",
+        resolved_mode="analysis_mode",
+        effective_command="send_message",
+        emitter=emitter,
+        build_llm_execution_trace_fn=lambda **kwargs: {"status": kwargs["status"], "mode_key": kwargs["mode_key"]},
+    )
+
+    assert [_event_name(event) for event in events] == ["phase.start", "heartbeat", "execution_trace"]

flare_kernel-0.2.13/tests/test_streaming_draft_prologue.py

@@ -1,45 +0,0 @@
-from __future__ import annotations
-
-import json
-
-from flare_kernel.contracts import KernelRequest
-from flare_kernel.router.streaming.draft.prologue import build_draft_prologue_events
-from flare_kernel.router.streaming.event_emitter import StreamingEventEmitter
-
-
-def _build_emitter() -> StreamingEventEmitter:
-    return StreamingEventEmitter(
-        req=KernelRequest(client_request_id="client-1", last_turn_id="turn-1"),
-        trace_id="trace-1",
-        session_id="session-1",
-        request_id="request-1",
-        patch_scopes={"analysis", "errors", "session", "assistant_reply"},
-        build_patch_event_fn=lambda **kwargs: {"event_type": kwargs["event_type"], "payload": kwargs["payload"]},
-        safe_session_id_fn=lambda value: str(value),
-    )
-
-
-def _event_name(event_text: str) -> str:
-    return event_text.split("\n", 1)[0].replace("event: ", "", 1)
-
-
-def _event_payload(event_text: str) -> dict:
-    line = event_text.split("\n")[1]
-    return json.loads(line.replace("data: ", "", 1))
-
-
-def test_build_draft_prologue_events_emits_bootstrap_sequence() -> None:
-    emitter = _build_emitter()
-
-    events = build_draft_prologue_events(
-        req=KernelRequest(session_id="session-1"),
-        trace_id="trace-1",
-        session_id="session-1",
-        request_id="request-1",
-        resolved_mode="requirement_intake",
-        emitter=emitter,
-        build_llm_execution_trace_fn=lambda **kwargs: {"status": kwargs["status"], "mode_key": kwargs["mode_key"]},
-    )
-
-    assert [_event_name(event) for event in events] == ["phase.start", "heartbeat", "execution_trace"]
-    assert _event_payload(events[-1])["status"] == "running"