TencentCloud
diff --git a/‎.gitignore‎
Lines changed: 1 addition & 0 deletions b/‎.gitignore‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎Makefile‎
Lines changed: 36 additions & 0 deletions b/‎Makefile‎
Lines changed: 36 additions & 0 deletions
diff --git a/‎dashboard/eslint.config.js‎
Lines changed: 10 additions & 0 deletions b/‎dashboard/eslint.config.js‎
Lines changed: 10 additions & 0 deletions
diff --git a/‎dashboard/src/api/modules/memoryDashboard.ts‎
Lines changed: 88 additions & 1 deletion b/‎dashboard/src/api/modules/memoryDashboard.ts‎
Lines changed: 88 additions & 1 deletion
diff --git a/‎dashboard/src/locales/en.json‎
Lines changed: 95 additions & 1 deletion b/‎dashboard/src/locales/en.json‎
Lines changed: 95 additions & 1 deletion
@@ -30,6 +30,7 @@ pip-wheel-metadata/
 
 # Virtual environments
 .venv/
+.venv-online/
 venv/
 env/
 ENV/
 
@@ -51,6 +51,11 @@ help:
 	@echo "  dev-frontend     Start Vite dev server only"
 	@echo "  dev-backend      Start octop run only"
 	@echo ""
+	@echo "Online-deps targets (local Octop source + PyPI harness components):"
+	@echo "  install-online   Create .venv-online: Octop editable + harness-* from PyPI"
+	@echo "  test-online      pytest against .venv-online (not live)"
+	@echo "  run-online       Start octop run from .venv-online"
+	@echo ""
 	@echo "Quality targets (backend — CI ship bar):"
 	@echo "  all              lint + typecheck + test (backend)"
 	@echo "  lint             Ruff check + format check (src, tests)"
@@ -76,6 +81,7 @@ help:
 	@echo "  install-tools    Install build + twine for publishing"
 	@echo "  docs-cli         Regenerate docs/cli.md from Click commands"
 	@echo "  clean            Remove build artifacts and caches"
+	@echo "  clean-online     Remove the .venv-online environment"
 	@echo "  version          Show current project version"
 
 # ─── Build ───────────────────────────────────────────────────────────────────
@@ -162,6 +168,30 @@ dev-frontend:
 dev-backend:
 	$(RUN) octop run
 
+# ─── Online-deps dev (local Octop source + PyPI harness components) ───────────
+# Keeps a dedicated .venv-online alongside .venv. Octop itself is installed
+# editable (-e) so source edits are live; the harness-* siblings are pulled
+# from PyPI (--no-sources ignores the editable local paths in uv.lock).
+# Re-run install-online only when a dependency version changes.
+VENV_ONLINE := $(REPO_ROOT)/.venv-online
+PY_ONLINE   := $(VENV_ONLINE)/bin
+
+.PHONY: install-online
+install-online:
+	@echo "[install-online] Creating $(VENV_ONLINE) (local Octop + PyPI harness deps)..."
+	uv venv $(VENV_ONLINE) --python 3.12
+	uv pip install --no-sources --python $(PY_ONLINE)/python -e ".[dev]"
+	@echo "[install-online] Done. Octop=editable(local), harness-*=PyPI."
+
+.PHONY: test-online
+test-online:
+	@echo "[test-online] pytest against $(VENV_ONLINE) (not live)..."
+	$(PY_ONLINE)/pytest -m "not live"
+
+.PHONY: run-online
+run-online:
+	$(PY_ONLINE)/octop run
+
 # ─── Quality (backend) ───────────────────────────────────────────────────────
 
 .PHONY: all
@@ -261,6 +291,12 @@ clean:
 	find $(REPO_ROOT)/src -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true
 	@echo "[clean] Done."
 
+.PHONY: clean-online
+clean-online:
+	@echo "[clean-online] Removing $(VENV_ONLINE)..."
+	rm -rf $(VENV_ONLINE)
+	@echo "[clean-online] Done."
+
 .PHONY: version
 version:
 	@$(PYTHON) -c "import pathlib, re; t = pathlib.Path('pyproject.toml').read_text(); m = re.search(r'^version\\s*=\\s*\"([^\"]+)\"', t, re.M); print(m.group(1) if m else 'unknown')"
@@ -20,6 +20,16 @@ export default tseslint.config(
     rules: {
       ...reactHooks.configs.recommended.rules,
       "react-refresh/only-export-components": "off",
+      // Honour the `_`-prefix convention for intentionally-unused bindings
+      // (discarded destructures, placeholder callback args).
+      "@typescript-eslint/no-unused-vars": [
+        "error",
+        {
+          argsIgnorePattern: "^_",
+          varsIgnorePattern: "^_",
+          ignoreRestSiblings: true,
+        },
+      ],
     },
   },
 );
@@ -60,6 +60,49 @@ export interface ListAtomsResponse {
   has_more: boolean;
 }
 
+export interface RawEventItem {
+  id: string;
+  host: string;
+  session_id: string | null;
+  thread_id: string | null;
+  user: string | null;
+  timestamp: string;
+  event_type: string;
+  content: string;
+  payload?: Record<string, unknown>;
+}
+
+export interface ListRawEventsResponse {
+  items: RawEventItem[];
+  total: number;
+  has_more: boolean;
+}
+
+export interface ListRawEventsBody {
+  session_id?: string;
+  thread_id?: string;
+  event_type?: string;
+  query?: string;
+  offset?: number;
+  limit?: number;
+}
+
+export type ExtractTriggerMode = "idle" | "interval";
+
+export interface ExtractConfig {
+  /** Missing on older Octop API processes; absence keeps the historical enabled default. */
+  memory_enabled?: boolean;
+  extract_on_session_end: boolean;
+  extract_trigger_mode: ExtractTriggerMode;
+  extract_idle_seconds: number;
+  extract_interval_seconds: number;
+  /**
+   * "provider/model" ref used for extraction / promotion. null/absent = AUTO
+   * (follow the chat model); send "" to reset back to AUTO.
+   */
+  aux_model?: string | null;
+}
+
 export interface EntityItem {
   id: string;
   entity_type: string;
@@ -70,6 +113,21 @@ export interface EntityItem {
   page_dirty?: boolean;
 }
 
+/** L3 entity page — the long-form, LLM-regenerated summary for a topic. */
+export interface EntityPage {
+  id: string;
+  entity_id: string;
+  summary_markdown: string;
+  headline: string;
+  topics: string[];
+  dirty: boolean;
+  summary_version: number;
+  created_at: string;
+  updated_at: string;
+}
+
+export type EntityDetail = EntityItem & { page: EntityPage | null };
+
 export interface ListEntitiesResponse {
   items: EntityItem[];
   total: number;
@@ -94,6 +152,20 @@ export interface ListEpisodesResponse {
   has_more: boolean;
 }
 
+/** Structured run stats attached to an ``extract_run`` journal entry. */
+export interface ExtractRunStats {
+  events_considered?: number;
+  events_extracted?: number;
+  candidates?: number;
+  promoted?: number;
+  merged?: number;
+  conflicts?: number;
+  needs_review?: number;
+  dropped?: number;
+  llm_calls?: number;
+  failure_reason?: string | null;
+}
+
 export interface JournalItem {
   id: string;
   timestamp: string;
@@ -105,6 +177,8 @@ export interface JournalItem {
   note?: string | null;
   /** Short target memory/topic text enriched by the backend for specific action display. */
   target_summary?: string | null;
+  /** Present on ``extract_run`` rows: structured stats for this extraction pass. */
+  after?: ExtractRunStats | null;
 }
 
 export interface ListJournalResponse {
@@ -296,12 +370,15 @@ export const memoryDashboardApi = {
   listCandidates: (aid: string, body?: ListCandidatesBody) =>
     post<ListCandidatesResponse>(`${base(aid)}/candidates/list`, body),
 
+  listRawEvents: (aid: string, body?: ListRawEventsBody) =>
+    post<ListRawEventsResponse>(`${base(aid)}/raw_events/list`, body),
+
   // single fetches
   getAtom: (aid: string, atomId: string) =>
     request<AtomItem>(`${base(aid)}/atoms/${encodeURIComponent(atomId)}`),
 
   getEntity: (aid: string, entityId: string) =>
-    request<EntityItem & { page: unknown | null }>(
+    request<EntityDetail>(
       `${base(aid)}/entities/${encodeURIComponent(entityId)}`,
     ),
 
@@ -385,6 +462,16 @@ export const memoryDashboardApi = {
     request<TerminalEntityResponse>(
       `${base(aid)}/terminal/entities?limit=${limit}`,
     ),
+
+  // extraction-trigger config
+  getExtractConfig: (aid: string) =>
+    request<ExtractConfig>(`${base(aid)}/extract-config`),
+
+  putExtractConfig: (aid: string, body: Partial<ExtractConfig>) =>
+    request<ExtractConfig>(`${base(aid)}/extract-config`, {
+      method: "PUT",
+      body: JSON.stringify(body),
+    }),
 };
 
 export default memoryDashboardApi;
@@ -850,6 +850,16 @@
     "rankingsEmpty": "No skills in this ranking yet",
     "agentSkillsLib": "{{agent}}'s skills library (/skills/<name>/SKILL.md)",
     "noAgentSelected": "Pick an agent in the top switcher first",
+    "tabs": {
+      "overview": "Overview",
+      "profile": "Profile",
+      "library": "Memory tree",
+      "episodes": "Emotional journal",
+      "candidates": "All",
+      "journal": "Activity",
+      "proactive": "Proactive care",
+      "settings": "Settings"
+    },
     "noSkills": "No skills yet",
     "noSkillsDesc": "Create a custom skill — the agent will use it at the right moment.",
     "totalCount": "{{count}} skill(s)",
@@ -2105,7 +2115,91 @@
       "saveSuccess": "Search configuration saved",
       "applySuccess": "Search configuration applied",
       "saveAndApply": "Save & Apply"
-    }
+    },
+    "pipeline": {
+      "title": "Memory pipeline",
+      "stageRaw": "Conversation memory",
+      "stageRawHint": "Filtered material messages captured from conversations (counts don't map 1:1 to Conversations)",
+      "stagePending": "Pending review",
+      "stagePendingHint": "Distilled memory candidates",
+      "stageAtoms": "Promoted memories",
+      "stageAtomsHint": "Memories available for recall",
+      "hintNoRaw": "Start chatting and the system will capture material and distill memories automatically.",
+      "hintDistilling": "{{n}} pieces of conversation material captured. Distillation runs automatically once a session goes idle; the first memories usually appear after a few exchanges.",
+      "hintNormal": "Material is distilled automatically once a session goes idle; results land in Pending Review before becoming promoted memories.",
+      "emptyTitle": "Memories are still being distilled",
+      "emptyNoRaw": "No memories yet. Start chatting and the system will capture material and distill memories automatically.",
+      "emptyWithRaw": "{{n}} pieces of conversation material captured. Distillation runs automatically once a session goes idle; the first memories usually appear after a few exchanges.",
+      "emptyPendingSuffix": "{{n}} memory candidates are awaiting confirmation in Pending Review."
+    },
+    "library": {
+      "viewRaw": "Raw material",
+      "hintRaw": "Raw conversation material captured before distillation (counts don't map 1:1 to Conversations)"
+    },
+    "raw": {
+      "typeFilter": "Type",
+      "typeAll": "All types",
+      "typeUser": "User message",
+      "typeAssistant": "AI reply",
+      "typeToolCall": "Tool call",
+      "typeToolResult": "Tool result",
+      "searchPlaceholder": "Search material content",
+      "detailTitle": "Material detail",
+      "content": "Content",
+      "capturedAt": "Captured at"
+    },
+    "extractConfig": {
+      "title": "Memory distillation timing",
+      "subtitle": "Control when conversation material becomes memory",
+      "enableLabel": "Auto-distill memory",
+      "modeIdle": "Distill after conversation goes idle",
+      "modeIdleHint": "Waits for a quiet conversation — best memory quality (recommended)",
+      "modeInterval": "Distill on a fixed interval",
+      "modeIntervalHint": "Batch-distills on a schedule; may catch a mid-conversation session",
+      "idlePrefix": "After",
+      "minutes": "minutes of inactivity",
+      "intervalPrefix": "Every",
+      "hours": "hours",
+      "intervalNote": "Fixed-interval distillation may run before a session ends; the idle mode is recommended for most cases.",
+      "disabledHint": "When off, distillation runs only when a session is ended manually.",
+      "saved": "Saved — the agent will reload automatically",
+      "saveFailed": "Save failed"
+    },
+    "settings": {
+      "title": "Memory settings",
+      "description": "Control whether this agent uses memory and when conversations become long-term memory.",
+      "storageTitle": "Store memory",
+      "storageDescription": "Allow the agent to read existing memories and keep learning from new conversations.",
+      "enabled": "On",
+      "disabled": "Off",
+      "disabledTitle": "The agent will stop using memory",
+      "disabledDescription": "The agent will not read existing memories or capture and distill new ones. Existing memories and conversation history are kept and become available again when memory is re-enabled.",
+      "distillTitle": "Distillation timing",
+      "distillDescription": "Choose when conversation material is organized into recallable long-term memory.",
+      "extractModelTitle": "Extraction model",
+      "extractModelDescription": "The model used to distill memories. \"Auto\" follows the chat default model; you can also pin a cheaper or faster model for extraction.",
+      "extractModelAuto": "Auto (follow chat model)",
+      "reloadHint": "Saving reloads the agent automatically. Current conversations are retained.",
+      "loadFailed": "Failed to load memory settings",
+      "saved": "Saved — the agent will reload automatically",
+      "saveFailed": "Save failed"
+    },
+    "overview": {
+      "dashboardTitle": "Memory overview",
+      "dashboardSubtitle": "See what the agent remembers and whether memory processing is healthy.",
+      "memoryOn": "Memory active",
+      "memoryOff": "Memory off",
+      "atoms": "Long-term memories",
+      "entities": "Key topics",
+      "episodes": "Emotional moments",
+      "rawEvents": "Conversation memory",
+      "candidatesPending": "Needs attention",
+      "kindsTitle": "Memory types",
+      "kindsEmpty": "No memory type data yet",
+      "growthTitle": "Memory growth · 7 days",
+      "growthEmpty": "No new memories in the last 7 days"
+    },
+    "entitySummary": "Topic summary"
   },
   "personalization": {
     "title": "Scenarios",