ltcai 6.0.0 → 6.1.0

package/README.md

@@ -69,42 +69,42 @@ You need Lattice AI when:
 Choose the owner of the Brain. The profile is not a SaaS account by default; it
 is the local identity for the knowledge you keep.
 
-![Login](output/release/v6.0.0/screenshots/01-login.png)
+![Login](output/release/v6.1.0/screenshots/01-login.png)
 
 ### 2. Environment Analysis
 
 See what kind of local AI experience this computer can support before choosing a
 model.
 
-![Environment Analysis](output/release/v6.0.0/screenshots/02-environment-analysis.png)
+![Environment Analysis](output/release/v6.1.0/screenshots/02-environment-analysis.png)
 
 ### 3. Recommended Models
 
 Start with a short list: safest recommendation, faster model, stronger model.
 Advanced details stay available without overwhelming first-time users.
 
-![Recommended Models](output/release/v6.0.0/screenshots/03-recommended-models.png)
+![Recommended Models](output/release/v6.1.0/screenshots/03-recommended-models.png)
 
 ### 4. Install And Load
 
 Download and load only after consent. Lattice explains model size, local
 execution, and network use before work starts.
 
-![Install and Load](output/release/v6.0.0/screenshots/04-install-load-progress.png)
+![Install and Load](output/release/v6.1.0/screenshots/04-install-load-progress.png)
 
 ### 5. Brain Chat
 
 Talk normally. Useful decisions and context become memory, then appear later as
 topics, relationships, and graph structure.
 
-![Brain Chat Home](output/release/v6.0.0/screenshots/05-brain-chat-home.png)
+![Brain Chat Home](output/release/v6.1.0/screenshots/05-brain-chat-home.png)
 
 ### 6. Review Center
 
 Automation results are staged for review before they become durable decisions.
 Snooze, unsnooze, run now, approve, and dismiss actions stay explicit.
 
-![Review Center](output/release/v6.0.0/screenshots/13-review-center.png)
+![Review Center](output/release/v6.1.0/screenshots/13-review-center.png)
 
 ## Brain Depths
 
@@ -120,10 +120,10 @@ The user travels inward from everyday memory to deeper structure:
 
 Walkthrough:
 
-![v6.0.0 Living Brain walkthrough](output/release/v6.0.0/gifs/v6.0.0-living-brain-walkthrough.gif)
+![v6.1.0 Living Brain walkthrough](output/release/v6.1.0/gifs/v6.1.0-living-brain-walkthrough.gif)
 
 Screenshot index and capture notes:
-[output/release/v6.0.0/SCREENSHOT_INDEX.md](output/release/v6.0.0/SCREENSHOT_INDEX.md)
+[output/release/v6.1.0/SCREENSHOT_INDEX.md](output/release/v6.1.0/SCREENSHOT_INDEX.md)
 
 ## Install
 
@@ -200,33 +200,36 @@ See [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) for developer workflow details.
 
 ## Current Release Preparation
 
-The current development target is **6.0.0 Product Reset / Review Center Completion**:
-
-- Review Center now includes Pending, Snoozed, and All filters so users can find
-  deferred automation suggestions without waiting for expiry.
-- `/automation/reviews` adds explicit `unsnooze` support while preserving
-  read-time snooze expiry and `run_now != approve` semantics.
-- Review Center frontend code is split into `frontend/src/features/review/`
-  modules instead of living inside the Act page.
-- Review item frontend types are derived from regenerated OpenAPI component
-- schemas, and Review Center API calls use generated operation paths for list
-  and state-transition actions.
-- `app_factory.py` is decomposed behind runtime seams for session, hooks, web
-  shell, persistence, lifespan, automation, context/search, platform services,
-  app context, and router registration while preserving the frozen 364-entry
-  route/mount snapshot.
-- First-run copy now states the local-first trust boundary more directly:
-  knowledge stays on this computer by default, downloads/external transfer start
-  only after user action, and models remain replaceable.
-- All package/runtime/static/OpenAPI versions are synchronized to 6.0.0.
-
-Expected artifacts for 6.0.0 release must use exact filenames:
-
-- `dist/ltcai-6.0.0-py3-none-any.whl`
-- `dist/ltcai-6.0.0.tar.gz`
-- `ltcai-6.0.0.tgz`
-- `dist/ltcai-6.0.0.vsix`
-- `src-tauri/target/release/bundle/dmg/Lattice AI_6.0.0_aarch64.dmg`
+The current development target is **6.1.0 Product Hardening / Digital Brain Completion**:
+
+- First-run now lets users create or open the local Brain even when they defer
+  model setup, keeping the Brain durable while models stay replaceable.
+- Brain Home explains the first memory loop: save useful context, see it return
+  in the Brain state, then protect it with backup/export.
+- Review Center keeps Pending, Snoozed, and All filters while clarifying that
+  Run now is a preview/regenerate action, not approval.
+- `lattice_brain` has an AST import guard so Brain Core does not import
+  `latticeai` or `ltcai`.
+- Model download consent has a unit guard: token presence alone does not start
+  an external download path.
+- `ltcai_cli.py` keeps the root entrypoint while pure CLI runtime helpers live
+  under `latticeai.cli.runtime`.
+- Tool dispatch authorization now has an injectable service boundary around
+  the shared ToolRegistry, reducing app-factory reliance on module globals.
+- Chat agent runtime construction moved into app-factory assembly and is passed
+  through `AppContext`, so the chat router no longer owns production runtime
+  construction.
+- v6.1 documentation tracks backend hardening, frontend UX hardening, and the
+  baseline scan for version metadata, root legacy modules, Brain Core boundary,
+  and local-first trust gates.
+
+Expected artifacts for 6.1.0 release must use exact filenames:
+
+- `dist/ltcai-6.1.0-py3-none-any.whl`
+- `dist/ltcai-6.1.0.tar.gz`
+- `ltcai-6.1.0.tgz`
+- `dist/ltcai-6.1.0.vsix`
+- `src-tauri/target/release/bundle/dmg/Lattice AI_6.1.0_aarch64.dmg`
 
 Do not upload `dist/*`. Package registry publishing remains owner-run.
 

package/docs/CHANGELOG.md

@@ -3,6 +3,42 @@
 The top entry is the current release-preparation target. Older entries are
 historical and may describe behavior as it existed at that release.
 
+## [6.1.0] - 2026-06-16
+
+> Product Hardening / Digital Brain Completion. Tightens the local-first Brain
+> flow, Brain Core boundary, backend trust gates, and release documentation
+> without adding broad new product surfaces.
+
+### Added
+- First-run path to open the Brain without installing or loading a model first.
+- Brain Home empty-state loop that shows first memory save, Brain state return,
+  and backup ownership.
+- AST import guard proving `lattice_brain` does not import `latticeai` or
+  `ltcai`.
+- Unit coverage for model download consent blocking in `model_runtime`.
+- `latticeai.cli.runtime` for pure CLI runtime helpers while preserving the root
+  `ltcai_cli.py` entrypoint.
+- v6.1 baseline, frontend UX, backend hardening, and instruction documents under
+  `docs/v6.1/`.
+
+### Changed
+- Review Center cards clarify that Run now previews/executes without approval.
+- Static app assets are refreshed for the v6.1 frontend hardening changes.
+- Tool dispatch authorization now uses an injectable service boundary around
+  the shared ToolRegistry while preserving the legacy module-level API.
+- Chat agent runtime construction moved out of `create_chat_router` for
+  production app assembly and is now injected through `AppContext`.
+- README release evidence screenshots and walkthrough GIF are refreshed under
+  `output/release/v6.1.0/`, including the Review Center surface.
+- README and release notes now describe v6.1.0 as the current hardening target
+  with exact expected artifact filenames.
+
+### Preserved
+- Package publish, deployment, tag creation, and main merge remain out of scope
+  unless explicitly requested.
+- Package/runtime version metadata is synchronized to 6.1.0; package publish,
+  deployment, tag creation, and main merge remain owner-run only.
+
 ## [6.0.0] - 2026-06-15
 
 > Product Reset / Review Center Completion. Raises the Review Center from a

package/docs/V4_1_FRONTEND_MIGRATION_REPORT.md

@@ -61,7 +61,7 @@ contracts, and local-first/offline operation.
 - Legacy frontend build pipeline.
 - Legacy v3 frontend lint script.
 - Static v3 asset tree in release packages.
-- Direct current-release references to v4.0.1 in latest docs.
+- Direct then-current release references to v4.0.1 in then-latest docs.
 
 ## Data Preservation
 

package/docs/V4_6_1_RELEASE_REFRESH_REPORT.md

@@ -8,7 +8,7 @@ architecture or add unrelated product features.
 
 ## Completed Refresh Areas
 
-- Synchronized current-release version metadata to `4.6.1`.
+- Synchronized then-current release version metadata to `4.6.1`.
 - Reframed README around the current Living Brain flow:
   Login -> Environment Analysis -> Recommended Models -> Install & Load ->
   Brain Chat.

package/docs/V4_7_0_ADMIN_SEPARATION_REPORT.md

@@ -19,7 +19,7 @@ maintenance. This release does not redesign Brain Core or the storage layer.
 - Added frontend API helpers for `/admin/stats` and `/admin/security/events`.
 - Updated visual validation to confirm the admin console is separate from the
   user Brain surface.
-- Synchronized current-release version metadata to `4.7.0`.
+- Synchronized then-current release version metadata to `4.7.0`.
 - Updated README, RELEASE.md, release notes, changelog, architecture, security,
   feature status, VS Code extension docs, and release evidence references.
 

package/docs/V4_7_1_ADMIN_OPERATIONS_REPORT.md

@@ -26,7 +26,7 @@ maintenance. This release does not redesign Brain Core or the storage layer.
   admin observability state remain separate in the frontend runtime.
 - Updated visual validation to confirm the admin console is separate from the
   user Brain surface.
-- Synchronized current-release version metadata to `4.7.1`.
+- Synchronized then-current release version metadata to `4.7.1`.
 - Updated README, RELEASE.md, release notes, changelog, architecture, security,
   feature status, VS Code extension docs, and release evidence references.
 

package/frontend/src/App.tsx

@@ -382,6 +382,11 @@ function BrainHome({
                   </button>
                 ))}
               </div>
+              <div className="mind-empty-trail" aria-label={t(language, "brain.empty.trail.label")}>
+                <span>{t(language, "brain.empty.trail.save")}</span>
+                <span>{t(language, "brain.empty.trail.recall")}</span>
+                <span>{t(language, "brain.empty.trail.backup")}</span>
+              </div>
             </div>
           ) : (
             messages.map((message, index) => (

package/frontend/src/components/ProductFlow.tsx

@@ -123,6 +123,10 @@ export function ProductFlow({ onComplete }: { onComplete: () => void }) {
           <RecommendationScreen
             recommendations={recommendations}
             onBack={() => setStep("analysis")}
+            onSkipModel={() => {
+              try { localStorage.setItem(FLOW_COMPLETE_KEY, "true"); } catch {}
+              onComplete();
+            }}
             onSelect={(model) => {
               setSelected(model);
               setStep("install");
@@ -333,10 +337,12 @@ function AnalysisScreen({
 function RecommendationScreen({
   recommendations,
   onBack,
+  onSkipModel,
   onSelect,
 }: {
   recommendations: RecommendedModel[];
   onBack: () => void;
+  onSkipModel: () => void;
   onSelect: (model: RecommendedModel) => void;
 }) {
   const language = useAppStore((state) => state.language);
@@ -370,6 +376,7 @@ function RecommendationScreen({
 
       <div style={{ marginTop: "1.1rem", display: "flex", justifyContent: "center", gap: "1rem", alignItems: "center" }}>
         <Button variant="ghost" onClick={onBack}>{t(language, "flow.recommend.back")}</Button>
+        <Button variant="outline" onClick={onSkipModel}>{t(language, "flow.recommend.skip")}</Button>
         <div style={{ fontSize: "0.82rem", color: "hsl(var(--fg-muted))" }}>{t(language, "flow.recommend.hint")}</div>
       </div>
     </div>

package/frontend/src/features/review/ReviewCard.tsx

@@ -71,16 +71,21 @@ export function ReviewCard({ item, feedback, onAction }: ReviewCardProps) {
       ) : null}
 
       {actionable ? (
-        <div className="mt-4 flex flex-wrap gap-2">
-          <ActionButton
-            label="Run now"
-            successLabel={hadRun ? "Regenerated" : "Executed"}
-            action={() => onAction(item, "run_now", hadRun)}
-            invalidate={[]}
-          />
-          <ActionButton label="Approve" action={() => onAction(item, "approve")} invalidate={[]} />
-          {!snoozed ? <ActionButton label="Snooze 1 day" action={() => onAction(item, "snooze")} invalidate={[]} /> : null}
-          <ActionButton label="Dismiss" action={() => onAction(item, "dismiss")} invalidate={[]} variant="destructive" />
+        <div className="mt-4 grid gap-2">
+          <p className="text-xs leading-5 text-muted-foreground">
+            Run now previews the action without approving it. Approve or dismiss when the result looks right.
+          </p>
+          <div className="flex flex-wrap gap-2" aria-label="Review actions">
+            <ActionButton
+              label="Run now"
+              successLabel={hadRun ? "Regenerated" : "Executed"}
+              action={() => onAction(item, "run_now", hadRun)}
+              invalidate={[]}
+            />
+            <ActionButton label="Approve" action={() => onAction(item, "approve")} invalidate={[]} />
+            {!snoozed ? <ActionButton label="Snooze 1 day" action={() => onAction(item, "snooze")} invalidate={[]} /> : null}
+            <ActionButton label="Dismiss" action={() => onAction(item, "dismiss")} invalidate={[]} variant="destructive" />
+          </div>
         </div>
       ) : null}
       {feedback ? (

package/frontend/src/i18n.ts

@@ -31,6 +31,10 @@ export const COPY: Record<Language, TextMap> = {
     "brain.empty.kicker": "내 오래가는 기억",
     "brain.empty.title": "잊으면 안 되는 맥락부터 말해 주세요.",
     "brain.empty.body": "문서, 대화, 프로젝트, 결정이 이 컴퓨터의 Brain에 쌓이고 나중에 주제와 관계로 다시 보입니다.",
+    "brain.empty.trail.label": "첫 Brain 흐름",
+    "brain.empty.trail.save": "1. 첫 기억 저장",
+    "brain.empty.trail.recall": "2. Brain Home에서 확인",
+    "brain.empty.trail.backup": "3. 백업으로 소유",
     "brain.prompt.remember": "이 프로젝트 목표를 기억해줘: ",
     "brain.prompt.know": "이 문서를 내 Brain에 넣고 요약해줘: ",
     "brain.prompt.plan": "지난 결정들을 나중에 찾을 수 있게 정리해줘: ",
@@ -107,6 +111,7 @@ export const COPY: Record<Language, TextMap> = {
     "flow.recommend.primary": "추천대로 시작하기",
     "flow.recommend.unsupported": "이 컴퓨터에서 추가 확인이 필요합니다",
     "flow.recommend.back": "뒤로",
+    "flow.recommend.skip": "모델 없이 Brain 열기",
     "flow.recommend.hint": "잘 모르겠다면 추천대로 시작하면 됩니다.",
     "flow.install.title": "모델을 설치하고 시작합니다.",
     "flow.install.body": "이 모델이 Brain의 로컬 목소리가 됩니다. 인터넷은 다운로드할 때만 필요하고, 실행과 기억은 이 컴퓨터에서 유지됩니다.",
@@ -144,6 +149,10 @@ export const COPY: Record<Language, TextMap> = {
     "brain.empty.kicker": "Durable memory",
     "brain.empty.title": "Start with context that should not be forgotten.",
     "brain.empty.body": "Documents, conversations, projects, and decisions accumulate in the Brain on this computer, then reappear as topics and relationships.",
+    "brain.empty.trail.label": "First Brain flow",
+    "brain.empty.trail.save": "1. Save first memory",
+    "brain.empty.trail.recall": "2. See it in Brain Home",
+    "brain.empty.trail.backup": "3. Own it with backup",
     "brain.prompt.remember": "Remember this project goal: ",
     "brain.prompt.know": "Put this document into my Brain and summarize it: ",
     "brain.prompt.plan": "Organize past decisions so I can find them later: ",
@@ -220,6 +229,7 @@ export const COPY: Record<Language, TextMap> = {
     "flow.recommend.primary": "Start with recommendation",
     "flow.recommend.unsupported": "This computer needs one more check",
     "flow.recommend.back": "Back",
+    "flow.recommend.skip": "Open Brain without a model",
     "flow.recommend.hint": "If unsure, start with the recommendation.",
     "flow.install.title": "Install the model and start.",
     "flow.install.body": "This model becomes your Brain's local voice. Internet is needed only for download; execution and memory stay on this computer.",

package/frontend/src/styles.css

@@ -2774,6 +2774,26 @@ body {
   transform: translateY(-1px);
 }
 
+.mind-empty-trail {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: center;
+  gap: 0.45rem;
+  margin: 1rem auto 0;
+  max-width: 40rem;
+}
+
+.mind-empty-trail span {
+  border: 1px solid hsl(var(--border) / 0.55);
+  border-radius: 999px;
+  background: hsl(var(--surface-glass));
+  color: hsl(var(--fg-muted));
+  padding: 0.34rem 0.62rem;
+  font-size: 0.72rem;
+  font-weight: 720;
+  line-height: 1.15;
+}
+
 .mind-empty .icon {
   opacity: 0.5;
   margin-bottom: 0.8rem;

package/lattice_brain/__init__.py

@@ -26,7 +26,7 @@ from .storage import (
     storage_from_env,
 )
 
-__version__ = "6.0.0"
+__version__ = "6.1.0"
 
 __all__ = [
     "AgentRuntime",

package/lattice_brain/runtime/multi_agent.py

@@ -19,7 +19,7 @@ from datetime import datetime
 from typing import Any, Callable, Dict, List, Optional
 
 
-MULTI_AGENT_VERSION = "6.0.0"
+MULTI_AGENT_VERSION = "6.1.0"
 
 AGENT_ROLES = ("researcher", "planner", "executor", "reviewer", "release")
 CORE_PIPELINE = ("planner", "executor", "reviewer")

package/latticeai/__init__.py

@@ -1,3 +1,3 @@
 """Lattice AI - modular server package."""
 
-__version__ = "6.0.0"
+__version__ = "6.1.0"

package/latticeai/api/chat.py

@@ -150,6 +150,35 @@ async def single_text_stream(text: str, model: str = "system") -> AsyncIterator[
     yield "data: [DONE]\n\n"
 
 
+def build_recent_chat_context(
+    *,
+    get_history,
+    limit: int = 10,
+    include_image_missing_replies: bool = True,
+    user_email: Optional[str] = None,
+    conversation_id: Optional[str] = None,
+) -> str:
+    history = get_history()
+    if conversation_id:
+        history = [item for item in history if item.get("conversation_id") == conversation_id]
+    if user_email:
+        history = pair_user_history(history, user_email)
+    history = history[-limit:]
+    lines = []
+    for item in history:
+        role = item.get("role", "user")
+        content = item.get("content", "")
+        if not include_image_missing_replies and role == "assistant":
+            if "이미지" in content and any(word in content for word in ["업로드", "제공", "올려"]):
+                continue
+        source = item.get("source")
+        label = role
+        if source:
+            label = f"{role} ({source})"
+        lines.append(f"{label}: {content}")
+    return "\n".join(lines)
+
+
 def create_chat_router(context: AppContext) -> APIRouter:
     """Build the chat/history/agent router from the typed application context.
 
@@ -201,31 +230,19 @@ def create_chat_router(context: AppContext) -> APIRouter:
         except Exception as exc:
             logging.warning("chat message bridge failed: %s", exc)
 
-    def build_recent_chat_context(
+    def recent_chat_context(
         limit: int = 10,
         include_image_missing_replies: bool = True,
         user_email: Optional[str] = None,
         conversation_id: Optional[str] = None,
     ) -> str:
-        history = get_history()
-        if conversation_id:
-            history = [item for item in history if item.get("conversation_id") == conversation_id]
-        if user_email:
-            history = pair_user_history(history, user_email)
-        history = history[-limit:]
-        lines = []
-        for item in history:
-            role = item.get("role", "user")
-            content = item.get("content", "")
-            if not include_image_missing_replies and role == "assistant":
-                if "이미지" in content and any(word in content for word in ["업로드", "제공", "올려"]):
-                    continue
-            source = item.get("source")
-            label = role
-            if source:
-                label = f"{role} ({source})"
-            lines.append(f"{label}: {content}")
-        return "\n".join(lines)
+        return build_recent_chat_context(
+            get_history=get_history,
+            limit=limit,
+            include_image_missing_replies=include_image_missing_replies,
+            user_email=user_email,
+            conversation_id=conversation_id,
+        )
     
     def extract_screenshot_context(image_data: Optional[str]) -> str:
         if not image_data:
@@ -283,16 +300,18 @@ def create_chat_router(context: AppContext) -> APIRouter:
     
         return "\n".join(lines)
 
-    _AGENT_RUNTIME = build_agent_runtime(
-        model_router=router,
-        execute_tool=execute_tool,
-        recent_chat_context=build_recent_chat_context,
-        clear_history=clear_history,
-        knowledge_save=knowledge_save,
-        audit=append_audit_event,
-        hooks=hooks,
-        brain_memory=context.brain_memory,
-    )
+    _AGENT_RUNTIME = context.chat_agent_runtime
+    if _AGENT_RUNTIME is None:
+        _AGENT_RUNTIME = build_agent_runtime(
+            model_router=router,
+            execute_tool=execute_tool,
+            recent_chat_context=recent_chat_context,
+            clear_history=clear_history,
+            knowledge_save=knowledge_save,
+            audit=append_audit_event,
+            hooks=hooks,
+            brain_memory=context.brain_memory,
+        )
 
     @api_router.post("/chat")
     async def chat(req: ChatRequest, request: Request):
@@ -546,7 +565,7 @@ def create_chat_router(context: AppContext) -> APIRouter:
                 return JSONResponse(content={"response": str(result), "trace_id": trace_record["id"], "trace": trace_record})
     
         if req.stream:
-            recent_context = build_recent_chat_context(user_email=effective_email, conversation_id=req.conversation_id)
+            recent_context = recent_chat_context(user_email=effective_email, conversation_id=req.conversation_id)
             stream_context = context
             if recent_context:
                 stream_context = f"[RECENT CONVERSATION]\n{recent_context}\n\n{context}".strip()
@@ -564,7 +583,7 @@ def create_chat_router(context: AppContext) -> APIRouter:
             )
         else:
             if req.image_data:
-                recent_context = build_recent_chat_context(
+                recent_context = recent_chat_context(
                     limit=6,
                     include_image_missing_replies=False,
                     user_email=effective_email,
@@ -572,7 +591,7 @@ def create_chat_router(context: AppContext) -> APIRouter:
                 )
                 full_context = f"[RECENT CONVERSATION]\n{recent_context}\n\n{context}".strip() if recent_context else context
             else:
-                history_context = build_recent_chat_context(user_email=effective_email, conversation_id=req.conversation_id)
+                history_context = recent_chat_context(user_email=effective_email, conversation_id=req.conversation_id)
                 full_context = f"{history_context}\n{context}" if context else history_context
     
             result = await router.generate(req.message, full_context, req.max_tokens, req.temperature, req.image_data)

package/latticeai/app_factory.py

@@ -153,7 +153,7 @@ def _build(config: "Optional[Config]" = None) -> Dict[str, Any]:
     from latticeai.api.invitations import create_invitations_router
     from latticeai.api.marketplace import create_marketplace_router
     from latticeai.api.models import create_models_router
-    from latticeai.api.chat import create_chat_router
+    from latticeai.api.chat import build_recent_chat_context, create_chat_router
     from latticeai.api.search import create_search_router
     from latticeai.api.tools import create_tools_router
     from latticeai.api.static_routes import create_static_routes_router
@@ -181,6 +181,7 @@ def _build(config: "Optional[Config]" = None) -> Dict[str, Any]:
         configure_tool_dispatch,
         get_tool_permission,
         list_tool_permissions,
+        build_agent_runtime,
         tool_response as _tool_response,
     )
     from latticeai.core.tool_registry import TOOL_CATALOG_BRIEF as _TOOL_CATALOG_BRIEF  # noqa: F401
@@ -190,7 +191,7 @@ def _build(config: "Optional[Config]" = None) -> Dict[str, Any]:
     )
     from p_reinforce import PReinforceGardener
     from setup_wizard import get_recommendations, scan_environment
-    from tools import ensure_agent_root
+    from tools import ensure_agent_root, execute_tool, knowledge_save
 
     try:
         import keyring
@@ -1242,6 +1243,31 @@ def _build(config: "Optional[Config]" = None) -> Dict[str, Any]:
             _spawn(broadcast_web_chat(role, text), name="telegram_broadcast")
         on_chat_message = _telegram_chat_mirror
 
+    def _recent_chat_context(
+        limit: int = 10,
+        include_image_missing_replies: bool = True,
+        user_email: Optional[str] = None,
+        conversation_id: Optional[str] = None,
+    ) -> str:
+        return build_recent_chat_context(
+            get_history=get_history,
+            limit=limit,
+            include_image_missing_replies=include_image_missing_replies,
+            user_email=user_email,
+            conversation_id=conversation_id,
+        )
+
+    CHAT_AGENT_RUNTIME = build_agent_runtime(
+        model_router=router,
+        execute_tool=execute_tool,
+        recent_chat_context=_recent_chat_context,
+        clear_history=clear_history,
+        knowledge_save=knowledge_save,
+        audit=append_audit_event,
+        hooks=HOOKS_REGISTRY,
+        brain_memory=BRAIN_MEMORY,
+    )
+
     # ── Typed dependency context (latticeai.services.app_context) ────────────────
     # One context object replaces the historical 25-30-kwarg router wiring.
     context = build_app_context(
@@ -1258,6 +1284,7 @@ def _build(config: "Optional[Config]" = None) -> Dict[str, Any]:
         chat_service=CHAT_SERVICE,
         context_assembler=CONTEXT_ASSEMBLER,
         brain_memory=BRAIN_MEMORY,
+        chat_agent_runtime=CHAT_AGENT_RUNTIME,
         gardener=gardener,
         hooks=HOOKS_REGISTRY,
         realtime_bus=REALTIME_BUS,

package/latticeai/cli/__init__.py

@@ -0,0 +1 @@
+"""LatticeAI CLI package."""

package/latticeai/cli/runtime.py

@@ -0,0 +1,37 @@
+"""Pure runtime helpers extracted from ltcai_cli entrypoint."""
+
+from __future__ import annotations
+
+import importlib.util
+import os
+from pathlib import Path
+
+
+def _load_env_file(path: Path) -> None:
+    if not path.exists():
+        return
+    for raw_line in path.read_text(encoding="utf-8").splitlines():
+        line = raw_line.strip()
+        if not line or line.startswith("#") or "=" not in line:
+            continue
+        key, value = line.split("=", 1)
+        key = key.strip()
+        value = value.strip().strip('"').strip("'")
+        if key and key not in os.environ:
+            os.environ[key] = value
+
+
+def _apply_extra_path() -> None:
+    extra = os.getenv("LATTICEAI_EXTRA_PATH", "")
+    if not extra:
+        return
+    current = [p for p in os.environ.get("PATH", "").split(os.pathsep) if p]
+    for item in reversed([p for p in extra.split(os.pathsep) if p]):
+        expanded = str(Path(item).expanduser())
+        if Path(expanded).exists() and expanded not in current:
+            current.insert(0, expanded)
+    os.environ["PATH"] = os.pathsep.join(current)
+
+
+def _has_module(name: str) -> bool:
+    return importlib.util.find_spec(name) is not None

package/latticeai/core/marketplace.py

@@ -11,7 +11,7 @@ from copy import deepcopy
 from typing import Any, Dict, List, Optional
 
 
-MARKETPLACE_VERSION = "6.0.0"
+MARKETPLACE_VERSION = "6.1.0"
 TEMPLATE_KINDS = ("plugin", "workflow", "agent")
 
 

package/latticeai/core/workspace_os.py

@@ -19,7 +19,7 @@ from pathlib import Path
 from typing import Any, Callable, Dict, Iterable, List, Optional
 
 
-WORKSPACE_OS_VERSION = "6.0.0"
+WORKSPACE_OS_VERSION = "6.1.0"
 
 # Workspace types separate single-user Personal workspaces from shared
 # Organization workspaces. Both keep the same local-first JSON store; the type