Staging

.github/workflows/living-ui.yml

@@ -0,0 +1,61 @@
+name: living-ui
+
+# Self-test for the Living UI TEMPLATE code (kit/blueprint/tools) in this repo.
+# Scaffolds a throwaway project and runs the local validation gate on it.
+# User-made Living UIs never touch this workflow — they validate locally.
+
+on:
+  push:
+    paths:
+      - 'living-ui/**'
+      - '.github/workflows/living-ui.yml'
+  pull_request:
+    paths:
+      - 'living-ui/**'
+      - '.github/workflows/living-ui.yml'
+
+defaults:
+  run:
+    working-directory: living-ui
+
+jobs:
+  gate:
+    name: gate (${{ matrix.os }})
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+
+      - name: Cache PocketBase binary
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/Library/Caches/craftos-living-ui/pb
+            ~/.cache/craftos-living-ui/pb
+            ~\AppData\Local\craftos-living-ui\pb
+          key: pb-${{ runner.os }}-${{ hashFiles('living-ui/spec/pocketbase.version') }}
+
+      - name: Install workspace
+        run: npm install
+
+      - name: Typecheck (kit + tools)
+        run: npm run typecheck
+
+      - name: Lint
+        run: npx eslint .
+
+      - name: Scaffold demo project
+        run: node tools/src/cli.ts create "CI Demo" --description "CI validation project" --port 8090
+
+      - name: Link demo workspace
+        run: npm install
+
+      - name: Validation gate
+        run: node tools/src/cli.ts validate examples/ci-demo

.github/workflows/staging-lint.yml

@@ -18,7 +18,10 @@ jobs:
           python-version: "3.10"
 
       - name: Install ruff
-        run: pip install ruff
+        # Pinned: unpinned latest broke CI when ruff 0.16 started formatting
+        # markdown code blocks and expanded its default lint rules. Bump
+        # deliberately (upgrade, run `ruff format .`, commit both together).
+        run: pip install ruff==0.16.1
 
       - name: Check formatting
         run: ruff format --check .

.gitignore

@@ -56,4 +56,7 @@ agent_file_system/TASK_HISTORY.md
 !build_template.py
 docs/LIVING_UI_DEVELOPER_GUIDE.md
 agent_file_system/ACTIONS.md
-agent_bundle/
+agent_bundle/
+**/.craftbot/
+app/data/.file_index/
+.playwright-mcp

.ruff.toml

@@ -2,6 +2,14 @@ extend-exclude = [
     "app/data/living_ui_template",
 ]
 
+# Pin the rule set explicitly. The repo was linted against ruff's classic
+# defaults (E4/E7/E9/F); ruff 0.16 expanded its default selection (UP, BLE,
+# S, I, …), which turned a clean tree into 9,618 errors overnight because CI
+# installs unpinned latest. Selecting explicitly makes `ruff check .` mean
+# the same thing on every ruff version.
+[lint]
+select = ["E4", "E7", "E9", "F"]
+
 # E402 (module-level imports not at top) is triggered in files that deliberately
 # run setup code before imports — logging suppression, sys.path manipulation,
 # asyncio compatibility shims, or state-registry initialization that other
@@ -12,6 +20,5 @@ extend-exclude = [
 "agents/dog_agent/data/action/dog_behaviour.py" = ["E402"]
 "app/action/action_framework/run_actions_tests.py" = ["E402"]
 "app/config.py" = ["E402"]
-"app/llm_interface.py" = ["E402"]
 "app/main.py" = ["E402"]
 "craftos_integrations/__init__.py" = ["E402"]

README.md

@@ -21,6 +21,10 @@ Beyond that, CraftBot has all the core capabilities of a general-purpose agent h
   <a href="https://discord.gg/ZN9YHc37HG">
     <img src="https://img.shields.io/badge/Discord-Join%20the%20community-5865F2?logo=discord&logoColor=white" alt="Discord">
   </a>
+
+  <a href="https://deepwiki.com/CraftOS-dev/CraftBot">
+    <img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki">
+  </a>
 </p>
 
 <div align="center">

agent_core/__init__.py

@@ -16,7 +16,6 @@
     get_state_or_none,
     AgentProperties,
     ReasoningResult,
-    TaskSummary,
     MainState,
     DEFAULT_MAX_ACTIONS_PER_TASK,
     DEFAULT_MAX_TOKEN_PER_TASK,
@@ -34,7 +33,13 @@
 from agent_core.core.image_gen_interface import ImageGenInterface
 from agent_core.core.database_interface import DatabaseInterface
 from agent_core.core.trigger import Trigger
-from agent_core.core.task import Task, TodoItem, TodoStatus
+from agent_core.core.session import (
+    Session,
+    SessionType,
+    TodoItem,
+    TodoStatus,
+    MAIN_SESSION_ID,
+)
 from agent_core.core.action_framework import (
     ActionRegistry,
     ActionMetadata,
@@ -113,10 +118,10 @@
     get_event_stream_or_none,
     get_event_stream_manager,
     get_event_stream_manager_or_none,
-    # Task manager
-    TaskManagerRegistry,
-    get_task_manager,
-    get_task_manager_or_none,
+    # Session manager
+    SessionManagerRegistry,
+    get_session_manager,
+    get_session_manager_or_none,
     # State manager
     StateManagerRegistry,
     get_state_manager,
@@ -125,15 +130,8 @@
     ContextEngineRegistry,
     get_context_engine,
     get_context_engine_or_none,
-    # Trigger queue
-    TriggerQueueRegistry,
-    get_trigger_queue,
-    get_trigger_queue_or_none,
 )
 from agent_core.core.hooks import (
-    OnTaskCreatedHook,
-    OnTaskEndedHook,
-    OnTodoTransitionHook,
     OnActionStartHook,
     OnActionEndHook,
     OnEventLoggedHook,
@@ -152,18 +150,15 @@
     ActionLibrary,
     ActionRouter,
     ActionManager,
-    set_gui_execute_hook,
 )
 from agent_core.core.impl.memory import (
     MemoryManager,
     MemoryFileWatcher,
     MemoryPointer,
     MemoryChunk,
-    create_memory_processing_task,
 )
 from agent_core.core.impl.llm import LLMCallType
-from agent_core.core.impl.trigger import TriggerQueue
-from agent_core.core.impl.workflow_lock import WorkflowLockManager
+from agent_core.core.impl.trigger import SessionTriggerQueue, QueueClosed
 from agent_core.core.impl.event_stream import (
     EventStream,
     EventStreamManager,
@@ -180,28 +175,13 @@
     EVENT_STREAM_SUMMARIZATION_PROMPT,
     # Action prompts
     SELECT_ACTION_PROMPT,
-    SELECT_ACTION_IN_TASK_PROMPT,
-    SELECT_ACTION_IN_GUI_PROMPT,
-    SELECT_ACTION_IN_SIMPLE_TASK_PROMPT,
-    GUI_ACTION_SPACE_PROMPT,
     # Context prompts
     AGENT_ROLE_PROMPT,
     AGENT_INFO_PROMPT,
     POLICY_PROMPT,
     USER_PROFILE_PROMPT,
     ENVIRONMENTAL_CONTEXT_PROMPT,
     AGENT_FILE_SYSTEM_CONTEXT_PROMPT,
-    # Routing prompts
-    ROUTE_TO_SESSION_PROMPT,
-    # GUI prompts
-    GUI_REASONING_PROMPT,
-    GUI_REASONING_PROMPT_OMNIPARSER,
-    GUI_QUERY_FOCUSED_PROMPT,
-    GUI_PIXEL_POSITION_PROMPT,
-    # Skill selection prompts
-    SKILLS_AND_ACTION_SETS_SELECTION_PROMPT,
-    SKILL_SELECTION_PROMPT,
-    ACTION_SET_SELECTION_PROMPT,
 )
 
 # MCP
@@ -259,7 +239,6 @@
     "get_state_or_none",
     "AgentProperties",
     "ReasoningResult",
-    "TaskSummary",
     "MainState",
     "DEFAULT_MAX_ACTIONS_PER_TASK",
     "DEFAULT_MAX_TOKEN_PER_TASK",
@@ -300,10 +279,12 @@
     "PLATFORM_LINUX",
     "PLATFORM_WINDOWS",
     "PLATFORM_DARWIN",
-    # Task management
-    "Task",
+    # Session management
+    "Session",
+    "SessionType",
     "TodoItem",
     "TodoStatus",
+    "MAIN_SESSION_ID",
     # Event stream
     "Event",
     "EventRecord",
@@ -354,32 +335,27 @@
     "get_event_stream_or_none",
     "get_event_stream_manager",
     "get_event_stream_manager_or_none",
-    "TaskManagerRegistry",
-    "get_task_manager",
-    "get_task_manager_or_none",
+    "SessionManagerRegistry",
+    "get_session_manager",
+    "get_session_manager_or_none",
     "StateManagerRegistry",
     "get_state_manager",
     "get_state_manager_or_none",
     "ContextEngineRegistry",
     "get_context_engine",
     "get_context_engine_or_none",
-    "TriggerQueueRegistry",
-    "get_trigger_queue",
-    "get_trigger_queue_or_none",
     # Implementations
     "ActionExecutor",
     "ActionLibrary",
     "ActionRouter",
     "ActionManager",
-    "set_gui_execute_hook",
     "MemoryManager",
     "MemoryFileWatcher",
     "MemoryPointer",
     "MemoryChunk",
-    "create_memory_processing_task",
     "LLMCallType",
-    "TriggerQueue",
-    "WorkflowLockManager",
+    "SessionTriggerQueue",
+    "QueueClosed",
     "EventStream",
     "EventStreamManager",
     # Prompts - Registry
@@ -391,32 +367,14 @@
     "EVENT_STREAM_SUMMARIZATION_PROMPT",
     # Prompts - Action
     "SELECT_ACTION_PROMPT",
-    "SELECT_ACTION_IN_TASK_PROMPT",
-    "SELECT_ACTION_IN_GUI_PROMPT",
-    "SELECT_ACTION_IN_SIMPLE_TASK_PROMPT",
-    "GUI_ACTION_SPACE_PROMPT",
     # Prompts - Context
     "AGENT_ROLE_PROMPT",
     "AGENT_INFO_PROMPT",
     "POLICY_PROMPT",
     "USER_PROFILE_PROMPT",
     "ENVIRONMENTAL_CONTEXT_PROMPT",
     "AGENT_FILE_SYSTEM_CONTEXT_PROMPT",
-    # Prompts - Routing
-    "ROUTE_TO_SESSION_PROMPT",
-    # Prompts - GUI
-    "GUI_REASONING_PROMPT",
-    "GUI_REASONING_PROMPT_OMNIPARSER",
-    "GUI_QUERY_FOCUSED_PROMPT",
-    "GUI_PIXEL_POSITION_PROMPT",
-    # Prompts - Skill selection
-    "SKILLS_AND_ACTION_SETS_SELECTION_PROMPT",
-    "SKILL_SELECTION_PROMPT",
-    "ACTION_SET_SELECTION_PROMPT",
     # Hooks
-    "OnTaskCreatedHook",
-    "OnTaskEndedHook",
-    "OnTodoTransitionHook",
     "OnActionStartHook",
     "OnActionEndHook",
     "OnEventLoggedHook",

agent_core/core/__init__.py

@@ -12,7 +12,13 @@
 from agent_core.core.vlm_interface import VLMInterface
 from agent_core.core.database_interface import DatabaseInterface
 from agent_core.core.trigger import Trigger
-from agent_core.core.task import Task, TodoItem, TodoStatus
+from agent_core.core.session import (
+    Session,
+    SessionType,
+    TodoItem,
+    TodoStatus,
+    MAIN_SESSION_ID,
+)
 from agent_core.core.action_framework import (
     ActionRegistry,
     ActionMetadata,
@@ -55,10 +61,12 @@
     "get_cache_metrics",
     # Trigger
     "Trigger",
-    # Task
-    "Task",
+    # Session
+    "Session",
+    "SessionType",
     "TodoItem",
     "TodoStatus",
+    "MAIN_SESSION_ID",
     # Action framework
     "ActionRegistry",
     "ActionMetadata",