@openviking/openclaw-plugin 2026.6.18 → 2026.7.15

package/services/context-message-adapter.ts

@@ -1,4 +1,5 @@
 import type { OVMessage } from "../client.js";
+import { sanitizeOpenVikingPeerId } from "../routing/identity-routing.js";
 import { sanitizeToolUseResultPairing } from "../session-transcript-repair.js";
 
 export type AgentMessage = {
@@ -8,15 +9,7 @@ export type AgentMessage = {
 };
 
 export function toRoleId(senderId: string | undefined): string | undefined {
-  if (!senderId) {
-    return undefined;
-  }
-  const normalized = senderId
-    .trim()
-    .replace(/[^a-zA-Z0-9_-]+/g, "_")
-    .replace(/^_+|_+$/g, "")
-    .replace(/_+/g, "_");
-  return normalized || undefined;
+  return sanitizeOpenVikingPeerId(senderId);
 }
 
 /**

package/services/setup/probe-service.ts

@@ -1,3 +1,8 @@
+import {
+  resolveOpenVikingRequestHeaders,
+  type OpenVikingRequestHeaders,
+} from "../../request-headers.js";
+
 export type SetupNetworkTransport = (url: string, init: RequestInit) => Promise<Response>;
 
 export type SetupVersionCompatibility = "compatible" | "server_too_old" | "server_too_new" | "unknown";
@@ -27,8 +32,16 @@ export type SetupNetworkProbeOptions = {
 };
 
 export type SetupNetworkProbes = {
-  probeApiKeyType: (baseUrl: string, apiKey?: string) => Promise<SetupApiKeyProbeResult>;
-  checkServiceHealth: (baseUrl: string, apiKey?: string) => Promise<SetupHealthResult>;
+  probeApiKeyType: (
+    baseUrl: string,
+    apiKey?: string,
+    headers?: OpenVikingRequestHeaders,
+  ) => Promise<SetupApiKeyProbeResult>;
+  checkServiceHealth: (
+    baseUrl: string,
+    apiKey?: string,
+    headers?: OpenVikingRequestHeaders,
+  ) => Promise<SetupHealthResult>;
 };
 
 export const defaultSetupNetworkTransport: SetupNetworkTransport = (url, init) => fetch(url, init);
@@ -41,7 +54,11 @@ export function createSetupNetworkProbes({
   timeoutMs = 10_000,
 }: SetupNetworkProbeOptions): SetupNetworkProbes {
   return {
-    async probeApiKeyType(baseUrl: string, apiKey?: string): Promise<SetupApiKeyProbeResult> {
+    async probeApiKeyType(
+      baseUrl: string,
+      apiKey?: string,
+      configuredHeaders?: OpenVikingRequestHeaders,
+    ): Promise<SetupApiKeyProbeResult> {
       if (!apiKey) {
         return { keyType: "no_key", needsAccountId: false, needsUserId: false, detail: "No API key configured" };
       }
@@ -50,7 +67,10 @@ export function createSetupNetworkProbes({
       const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
       const sessionsUrl = `${baseUrl.replace(/\/+$/, "")}/api/v1/sessions?limit=1`;
       try {
-        const headers: Record<string, string> = { "X-API-Key": apiKey };
+        const configuredRequestHeaders = resolveOpenVikingRequestHeaders({ headers: configuredHeaders });
+        const headers: Record<string, string> = {};
+        headers["X-API-Key"] = apiKey;
+        Object.assign(headers, configuredRequestHeaders);
         const response = await transport(sessionsUrl, {
           headers,
           signal: controller.signal,
@@ -82,6 +102,7 @@ export function createSetupNetworkProbes({
               "X-API-Key": apiKey,
               "X-OpenViking-Account": "__probe__",
               "X-OpenViking-User": "__probe__",
+              ...configuredRequestHeaders,
             };
             const probe2 = await transport(sessionsUrl, {
               headers: probeHeaders,
@@ -111,12 +132,20 @@ export function createSetupNetworkProbes({
       }
     },
 
-    async checkServiceHealth(baseUrl: string, apiKey?: string): Promise<SetupHealthResult> {
+    async checkServiceHealth(
+      baseUrl: string,
+      apiKey?: string,
+      configuredHeaders?: OpenVikingRequestHeaders,
+    ): Promise<SetupHealthResult> {
       const controller = new AbortController();
       const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
       try {
+        const configuredRequestHeaders = resolveOpenVikingRequestHeaders({ headers: configuredHeaders });
         const headers: Record<string, string> = {};
-        if (apiKey) headers["X-API-Key"] = apiKey;
+        if (apiKey) {
+          headers["X-API-Key"] = apiKey;
+        }
+        Object.assign(headers, configuredRequestHeaders);
         const response = await transport(`${baseUrl.replace(/\/+$/, "")}/health`, {
           headers,
           signal: controller.signal,

package/services/setup/setup-flow.ts

@@ -6,6 +6,10 @@ import {
   type SetupIO,
   type SlotActivationResult,
 } from "./config-writer.js";
+import {
+  cleanOpenVikingRequestHeaders,
+  type OpenVikingRequestHeaders,
+} from "../../request-headers.js";
 
 export type { SetupIO, SlotActivationResult };
 
@@ -38,6 +42,7 @@ export type SetupResult = {
     peer_prefix?: string;
     accountId?: string;
     userId?: string;
+    headers?: OpenVikingRequestHeaders;
     recallTargetTypes?: string[];
   };
   health?: HealthResult;
@@ -65,6 +70,7 @@ export type StatusResult = {
 export type SetupParams = {
   baseUrl: string;
   apiKey?: string;
+  headers?: OpenVikingRequestHeaders;
   peerRole?: "none" | "assistant" | "person";
   peerPrefix?: string;
   accountId?: string;
@@ -78,6 +84,7 @@ export type InteractiveRemoteConfigParams = {
   existing?: Record<string, unknown> | null;
   baseUrl: string;
   apiKey?: string;
+  headers?: OpenVikingRequestHeaders;
   peerRole?: "none" | "assistant" | "person";
   peerPrefix?: string;
   accountId?: string;
@@ -100,8 +107,16 @@ export type OpenVikingSetupService = {
 export type OpenVikingSetupServiceDependencies = {
   io: SetupIO;
   defaultRemoteUrl?: string;
-  checkServiceHealth: (baseUrl: string, apiKey?: string) => Promise<HealthResult>;
-  probeApiKeyType: (baseUrl: string, apiKey?: string) => Promise<ApiKeyProbeResult>;
+  checkServiceHealth: (
+    baseUrl: string,
+    apiKey?: string,
+    headers?: OpenVikingRequestHeaders,
+  ) => Promise<HealthResult>;
+  probeApiKeyType: (
+    baseUrl: string,
+    apiKey?: string,
+    headers?: OpenVikingRequestHeaders,
+  ) => Promise<ApiKeyProbeResult>;
 };
 
 export function maskKey(key: string): string {
@@ -114,10 +129,38 @@ export function isLegacyLocalMode(existing: Record<string, unknown>): boolean {
   return mode !== "remote";
 }
 
+function nonEmptyOpenVikingRequestHeaders(value: unknown): OpenVikingRequestHeaders | undefined {
+  const headers = cleanOpenVikingRequestHeaders(value);
+  return Object.keys(headers).length > 0 ? headers : undefined;
+}
+
+function callHealthProbe(
+  checkServiceHealth: OpenVikingSetupServiceDependencies["checkServiceHealth"],
+  baseUrl: string,
+  apiKey: string | undefined,
+  headers: OpenVikingRequestHeaders | undefined,
+): Promise<HealthResult> {
+  return headers
+    ? checkServiceHealth(baseUrl, apiKey, headers)
+    : checkServiceHealth(baseUrl, apiKey);
+}
+
+function callApiKeyProbe(
+  probeApiKeyType: OpenVikingSetupServiceDependencies["probeApiKeyType"],
+  baseUrl: string,
+  apiKey: string | undefined,
+  headers: OpenVikingRequestHeaders | undefined,
+): Promise<ApiKeyProbeResult> {
+  return headers
+    ? probeApiKeyType(baseUrl, apiKey, headers)
+    : probeApiKeyType(baseUrl, apiKey);
+}
+
 export function buildInteractiveRemotePluginConfig({
   existing,
   baseUrl,
   apiKey,
+  headers,
   peerRole,
   peerPrefix,
   accountId,
@@ -138,6 +181,11 @@ export function buildInteractiveRemotePluginConfig({
   else delete pluginCfg.accountId;
   if (userId) pluginCfg.userId = userId;
   else delete pluginCfg.userId;
+  if (headers !== undefined) {
+    const cleanHeaders = nonEmptyOpenVikingRequestHeaders(headers);
+    if (cleanHeaders) pluginCfg.headers = cleanHeaders;
+    else delete pluginCfg.headers;
+  }
   delete pluginCfg.configPath;
   delete pluginCfg.port;
   return pluginCfg;
@@ -153,8 +201,9 @@ export function createOpenVikingSetupService({
     async setupNonInteractive(configPath: string, params: SetupParams): Promise<SetupResult> {
       try {
         const { baseUrl, apiKey, peerRole, peerPrefix, accountId, userId, recallTargetTypes, allowOffline, forceSlot } = params;
+        const headers = nonEmptyOpenVikingRequestHeaders(params.headers);
 
-        const health = await checkServiceHealth(baseUrl, apiKey);
+        const health = await callHealthProbe(checkServiceHealth, baseUrl, apiKey, headers);
 
         if (!health.ok && !allowOffline) {
           return {
@@ -167,7 +216,7 @@ export function createOpenVikingSetupService({
           };
         }
 
-        const keyProbe = health.ok ? await probeApiKeyType(baseUrl, apiKey) : undefined;
+        const keyProbe = health.ok ? await callApiKeyProbe(probeApiKeyType, baseUrl, apiKey, headers) : undefined;
 
         if (keyProbe?.keyType === "root_key" && (!accountId || !userId)) {
           const missing: string[] = [];
@@ -190,6 +239,7 @@ export function createOpenVikingSetupService({
 
         const pluginCfg: Record<string, unknown> = { mode: "remote", baseUrl };
         if (apiKey) pluginCfg.apiKey = apiKey;
+        if (headers && Object.keys(headers).length > 0) pluginCfg.headers = headers;
         if (peerRole) pluginCfg.peer_role = peerRole;
         if (peerPrefix) pluginCfg.peer_prefix = peerPrefix;
         if (accountId) pluginCfg.accountId = accountId;
@@ -203,6 +253,7 @@ export function createOpenVikingSetupService({
           mode: "remote",
           baseUrl,
           ...(apiKey ? { apiKey: maskKey(apiKey) } : {}),
+          ...(headers && Object.keys(headers).length > 0 ? { headers } : {}),
           ...(peerRole ? { peer_role: peerRole } : {}),
           ...(peerPrefix ? { peer_prefix: peerPrefix } : {}),
           ...(accountId ? { accountId } : {}),
@@ -253,7 +304,8 @@ export function createOpenVikingSetupService({
     async useExistingRemoteConfig(configPath: string, existing: Record<string, unknown>): Promise<SetupResult> {
       const baseUrl = String(existing.baseUrl ?? defaultRemoteUrl);
       const apiKey = existing.apiKey ? String(existing.apiKey) : undefined;
-      const health = await checkServiceHealth(baseUrl, apiKey);
+      const headers = nonEmptyOpenVikingRequestHeaders(existing.headers);
+      const health = await callHealthProbe(checkServiceHealth, baseUrl, apiKey, headers);
       const slot = activateContextEngineSlot(configPath, false, io);
       return {
         success: true,
@@ -262,6 +314,7 @@ export function createOpenVikingSetupService({
           mode: String(existing.mode ?? "remote"),
           baseUrl,
           ...(apiKey ? { apiKey: maskKey(apiKey) } : {}),
+          ...(headers ? { headers } : {}),
           ...(existing.peer_role ? { peer_role: String(existing.peer_role) as "none" | "assistant" | "person" } : {}),
           ...(existing.peer_prefix ? { peer_prefix: String(existing.peer_prefix) } : {}),
           ...(existing.accountId ? { accountId: String(existing.accountId) } : {}),
@@ -283,8 +336,9 @@ export function createOpenVikingSetupService({
 
       const baseUrl = String(existing.baseUrl ?? defaultRemoteUrl);
       const apiKey = existing.apiKey ? String(existing.apiKey) : undefined;
-      const health = await checkServiceHealth(baseUrl, apiKey);
-      const keyProbe = health.ok ? await probeApiKeyType(baseUrl, apiKey) : undefined;
+      const headers = nonEmptyOpenVikingRequestHeaders(existing.headers);
+      const health = await callHealthProbe(checkServiceHealth, baseUrl, apiKey, headers);
+      const keyProbe = health.ok ? await callApiKeyProbe(probeApiKeyType, baseUrl, apiKey, headers) : undefined;
 
       return {
         configured: true,

package/skills/install-openviking-memory/SKILL.md

@@ -91,8 +91,8 @@ openclaw --version
 
 **If `openclaw` is missing:**
 
-> (CN) 你的系统没有安装 OpenClaw。请先安装 OpenClaw（>= 2026.4.8），然后再回来找我。
-> (EN) OpenClaw is not installed. Please install OpenClaw (>= 2026.4.8) first, then come back.
+> (CN) 你的系统没有安装 OpenClaw。请先安装 OpenClaw（>= 2026.5.27），然后再回来找我。
+> (EN) OpenClaw is not installed. Please install OpenClaw (>= 2026.5.27) first, then come back.
 
 **Stop. Do NOT continue.**
 
@@ -413,20 +413,22 @@ Expected output:
 > (CN) 🎉 全部搞定！OpenViking 长期记忆已经接好了。
 >
 > 工作方式：
-> - **每一轮**：你的对话会被自动归档到 OpenViking session 里
-> - **`/compact` 时**：归档消息会在 OpenViking 服务端被抽取成长期记忆
+> - **每一轮**：你的对话会被自动追加到 OpenViking session 里；自动抽取依赖阈值 commit 或 `/compact`
+> - **明确要记住时**：如果你说“记住/保存/存一下”某个长期事实，我会用 `memory_store` 立即提交到记忆管线
+> - **`/compact` 时**：待提交的 session 消息会在 OpenViking 服务端被抽取成长期记忆
 > - **后续会话**：每次回复前我都会自动搜一下相关记忆并带进上下文
 >
-> 想验证一下吗？跟我聊几句包含可记忆事实的话（例如"我的邮箱是 test@example.com"），然后调一下 `/compact`，再开新对话问"我的邮箱是？"，应该就能召回了。
+> 想验证一下吗？可以直接说“记住我的邮箱是 test@example.com”，让我通过 `memory_store` 立即提交；或者先聊几句包含可记忆事实的话，再调一下 `/compact`。之后开新对话问“我的邮箱是？”，应该就能召回了。
 
 > (EN) 🎉 All set! OpenViking long-term memory is connected.
 >
 > How it works:
-> - **Every turn**: our messages are auto-archived into an OpenViking session
-> - **On `/compact`**: archived messages are extracted into long-term memories on the OpenViking server
+> - **Every turn**: our messages are appended to an OpenViking session; automatic extraction depends on a threshold commit or `/compact`
+> - **Explicit remember requests**: if you ask me to remember/save/store a long-term fact, I can use `memory_store` to commit it immediately
+> - **On `/compact`**: pending session messages are extracted into long-term memories on the OpenViking server
 > - **Future sessions**: relevant memories are auto-retrieved and injected before my replies
 >
-> Want to verify? Tell me a few facts (e.g. "my email is test@example.com"), run `/compact`, then start a new chat and ask "what's my email?" — it should recall.
+> Want to verify? Say "remember my email is test@example.com" so I can commit it via `memory_store`, or tell me a few memory-worthy facts and run `/compact`. Then start a new chat and ask "what's my email?" — it should recall.
 
 ---
 
@@ -434,15 +436,25 @@ Expected output:
 
 ## How It Works
 
-The context-engine pipeline has three distinct stages — keep them apart, especially when telling users when memories become searchable long-term memory on the OpenViking server:
+The context-engine pipeline has three distinct stages plus one explicit write path — keep them apart, especially when telling users when memories become searchable long-term memory on the OpenViking server:
 
-- **Archive / capture (context-engine `afterTurn`)**: at the end of a user turn, the plugin commits user/assistant messages to the OpenViking session via `POST /api/v1/sessions/.../messages`. This is **archive only** — no memory extraction yet. You'll see session message counts grow on the server, but no new files under `viking://user/.../memories/`.
-- **Memory extraction (on `/compact`)**: memory extraction runs when the user invokes OpenClaw's `/compact` command. The server-side extraction pipeline reads the archived session and writes new memories. The plugin's `after_compaction` hook is currently reserved; the extraction itself is driven by the server. **No `/compact`, no new memory files.**
+- **Archive / capture (context-engine `afterTurn`)**: at the end of a user turn, the plugin appends user/assistant messages to the OpenViking session via `POST /api/v1/sessions/.../messages`. This is **session capture only** unless `pending_tokens` crosses `commitTokenThreshold`; below the threshold, no memory extraction runs yet. You'll see session message counts grow on the server, but no new files under `viking://user/.../memories/`.
+- **Memory extraction (threshold commit or `/compact`)**: memory extraction runs after a session commit. The commit can be triggered asynchronously when `afterTurn` crosses `commitTokenThreshold`, synchronously when the user invokes OpenClaw's `/compact` command, or explicitly by `memory_store`. The server-side extraction pipeline reads the archived session and writes new memories.
   - `captureMode: "semantic"` (default): server extraction pipeline filters all qualifying text.
   - `captureMode: "keyword"`: only text matching trigger words (e.g. "remember", "preference") is considered.
 - **Auto-Recall (context-engine `assemble()`)**: before prompt context is assembled, the plugin queries OpenViking for relevant memories and injects them into context. Recall works even when there are no extracted memories yet — you just won't see anything come back.
 
-**Practical implication for testing**: if you write down a fact and immediately try to recall it without `/compact`, the plugin will only retrieve it as recent session context (archived messages), not as a long-term memory. To verify long-term memory cross-session, you must run `/compact` first.
+**Practical implication for testing**: if you write down a short fact and immediately try to recall it without a threshold commit, `/compact`, or `memory_store`, the plugin may only retrieve it as recent session context, not as a long-term memory. To verify long-term memory cross-session deterministically, run `/compact` or use `memory_store` for the fact being tested.
+
+### Explicit long-term memory writes
+
+Auto-capture is best-effort and commit-dependent. When the user explicitly says to remember, save, or store an important long-term fact, preference, project, or decision, the agent should call `memory_store` instead of waiting for ordinary auto-capture.
+
+Use `memory_store` as the integration-side reliable path for durable-memory intent:
+
+- It writes the supplied text into an OpenViking session and calls `commit(wait=true)`.
+- It complements auto-capture; it does not replace normal session capture.
+- If it commits but extracts 0 memories, the explicit path has done its job. Treat that as a server-side extraction/model/configuration issue and check OpenViking logs.
 
 ## Available Tools
 
@@ -468,6 +480,8 @@ Example: user asks "What programming language did I say I like?"
 | `role` | No | Session role (default `user`) |
 | `sessionId` | No | Existing OpenViking session ID |
 
+Use this when the user explicitly asks to remember/save/store a long-term fact, preference, project, or decision.
+
 Example: user says "Remember my email is xxx@example.com".
 
 ### `memory_forget` — Delete Memories
@@ -578,7 +592,7 @@ These are the keys under `plugins.entries.openviking.config` in `openclaw.json`.
 | `userId` | — | Required when `apiKey` is a root key. |
 | `targetUri` | `viking://user/memories` | Default search scope URI. |
 | `timeoutMs` | (plugin default) | HTTP timeout for OpenViking calls. |
-| `autoCapture` | `true` | Auto-archive turn messages to OpenViking session at `afterTurn` (extraction itself runs on `/compact`, not here). |
+| `autoCapture` | `true` | Auto-append turn messages to the OpenViking session at `afterTurn`; extraction runs only after a threshold commit, `/compact`, or explicit `memory_store`. |
 | `captureMode` | `"semantic"` | Filter mode used by the server-side extraction pipeline: `semantic` or `keyword`. |
 | `captureMaxLength` | `24000` | Max text length per archived turn. |
 | `autoRecall` | `true` | Auto-recall and inject memories before reply. |
@@ -589,7 +603,7 @@ These are the keys under `plugins.entries.openviking.config` in `openclaw.json`.
 | `recallMaxInjectedChars` | `4000` | Hard cap on injected character count. Complete memories that do not fit are skipped, not truncated. |
 | `recallPreferAbstract` | (plugin default) | Prefer abstract memories over raw. |
 | `recallTokenBudget` | deprecated | Compatibility alias for `recallMaxInjectedChars`. |
-| `commitTokenThreshold` | `20000` | Pending-token threshold for async commit after turns; `0` commits every turn. |
+| `commitTokenThresholdRatio` | `0.5` | Async-commit threshold as a fraction (0-1) of the model context window (e.g. 0.5 = 50%); `0` commits every turn. |
 | `commitKeepRecentCount` | `10` | Recent messages kept live after afterTurn commit. Compact always uses `0`. |
 | `bypassSessionPatterns` | — | Glob patterns for sessions skipped by capture. |
 | `ingestReplyAssist` | (plugin default) | Reply-assist ingestion toggle. |
@@ -722,7 +736,7 @@ Match against actual stderr / JSON `error` strings.
 
 | Symptom (exact string) | Likely cause | Fix |
 |---|---|---|
-| `command not found: openclaw` | OpenClaw not installed | Stop. Ask user to install OpenClaw >= 2026.4.8. |
+| `command not found: openclaw` | OpenClaw not installed | Stop. Ask user to install OpenClaw >= 2026.5.27. |
 | `command not found: node` / `'node' is not recognized` | Node missing | Stop. Ask user to install Node.js >= 22. |
 | `429` / `rate limit` / `Too Many Requests` from `plugins install` | ClawHub throttle | Switch to backup Path B (`ov-install`). |
 | `not logged in` / `please log in` from `plugins install` | Anonymous user hit limit | Switch to backup Path B (`ov-install`). |

package/skills/openviking-context-database/SKILL.md

@@ -42,7 +42,7 @@ OpenClaw owns agent execution, prompts, and tool invocation. OpenViking owns lon
 | Layer | Current behavior |
 |---|---|
 | `assemble` | Rebuilds compressed session history from OpenViking and injects relevant recall into the latest user message. |
-| `afterTurn` | Appends only the new turn to the OpenViking session; may trigger async commit when `pending_tokens >= commitTokenThreshold`. |
+| `afterTurn` | Appends only the new turn to the OpenViking session; may trigger async commit when `pending_tokens >= tokenBudget * commitTokenThresholdRatio`. |
 | `compact` | Runs `commit(wait=true)`, waits for archive/extraction completion, and reads back latest archive overview. |
 | Tools | Memory recall/store/forget, archive search/expand, resource/skill import/search, recall trace query, tool-result list/search/read. |
 
@@ -77,7 +77,7 @@ Core config lives under `plugins.entries.openviking.config`:
 | `recallLimit` | `6` | Max selected recall items. |
 | `recallScoreThreshold` | `0.15` | Min score after post-processing. |
 | `recallMaxInjectedChars` | `4000` | Total injected character cap; complete memories that do not fit are skipped. |
-| `commitTokenThreshold` | `20000` | Pending-token threshold for async commit after turns; `0` commits every turn. |
+| `commitTokenThresholdRatio` | `0.5` | Async-commit threshold as a fraction (0-1) of the model context window (e.g. 0.5 = 50%); `0` commits every turn. |
 | `commitKeepRecentCount` | `10` | Recent messages kept live after afterTurn commit. Compact always uses `0`. |
 | `bypassSessionPatterns` | empty | Glob-like session keys that completely bypass OpenViking (`*` segment, `**` multi-segment). |
 | `emitStandardDiagnostics` | `false` | Emit structured `openviking: diag {...}` lines. |
@@ -272,7 +272,7 @@ Command parsers support quoted args and flags. Resource-only flags are rejected
 | `configured=false` | Setup did not persist config | Re-run `openclaw openviking setup ... --json`; branch on JSON `error`. |
 | `slotActive=false` | Another context engine owns the slot or gateway has stale state | Inspect `plugins.slots.contextEngine`; use `--force-slot` only after user confirms. |
 | `health.ok=false` | Server unreachable or wrong `baseUrl` / key | Check `baseUrl`, network, `/health`, and auth. |
-| No long-term memory after a fresh fact | `/compact` or commit/extraction has not run, or server extraction failed | Run `/compact`; check OpenViking server logs. |
+| No long-term memory after a fresh fact | `/compact` or commit/extraction has not run, or server extraction failed | Use `memory_store` for explicit remember/save/store intents; otherwise run `/compact` or wait for threshold commit, then check OpenViking server logs. |
 | Recall misses shared documents | `resource` target is not enabled | Use `memory_recall` with `resourceTypes:["resource"]` or configure `recallTargetTypes: ["resource"]`. |
 | Summary lacks exact detail | Archive summary is too coarse | Use `ov_archive_search` with concrete keywords, then `ov_archive_expand`. |
 | Large tool output preview is insufficient | Tool result was externalized | Use `openviking_tool_result_search/read` with the ref. |

package/text-utils.ts

@@ -44,14 +44,9 @@ function looksLikeMetadataJsonBlock(content: string): boolean {
   return matchedKeys.size >= 3;
 }
 
-const HEARTBEAT_RE = /\bHEARTBEAT(?:\.md|_OK)\b/;
 const TOOL_PLACEHOLDER_RE = /^\s*\[tool(?::\s*|Use:\s*)[^\]]+\]\s*$/i;
 
 export function sanitizeUserTextForCapture(text: string): string {
-  // 过滤 HEARTBEAT 健康检查消息
-  if (HEARTBEAT_RE.test(text)) {
-    return "";
-  }
   // Drop legacy synthetic tool placeholders before they reach memory extraction.
   if (TOOL_PLACEHOLDER_RE.test(text)) {
     return "";
@@ -409,7 +404,7 @@ export function extractNewTurnMessages(
           : undefined);
       if (output) {
         result.push({
-          role: "user",
+          role: "assistant",
           parts: [{
             type: "tool",
             toolCallId: toolCallId || undefined,