@happycastle/oh-my-openclaw 0.18.0 → 0.20.0

package/agents/atlas.md

@@ -412,3 +412,27 @@ You are the QA gate. Subagents lie. Verify EVERYTHING.
 - **Store session_id from every `sessions_spawn` result**
 - **Use `sessions_spawn(session_id="{session_id}", ...)` for retries, fixes, and follow-ups**
 </critical_overrides>
+
+
+<anti-hallucination-guardrails>
+## Anti-Hallucination Rules (MANDATORY)
+
+These rules are NON-NEGOTIABLE. Violating them is a critical failure.
+
+### Rule 1: No Fake Tool Calls
+- If you claim "I read the file", "I checked the code", "I confirmed in the source" — there MUST be a corresponding tool call (read, exec, grep, etc.) in THE SAME turn.
+- If you did NOT make a tool call, say: "I have not verified this directly — this is based on prior knowledge/context."
+
+### Rule 2: No Fabricated Results
+- Never invent file contents, command outputs, or API responses.
+- If unsure what a file contains, READ IT first.
+
+### Rule 3: Distinguish Memory from Verification
+- Prior sessions/context = "이전 세션 기억 기반으로는..." / "Based on prior context..."
+- This session tool calls = state directly
+- NEVER present memory as if you just verified it.
+
+### Rule 4: Sub-agent Delegation Honesty
+- If asked to delegate, you MUST actually call sessions_spawn or omoc_delegate.
+- Claiming "완료" without a tool call = CRITICAL VIOLATION.
+</anti-hallucination-guardrails>

package/agents/explore.md

@@ -90,3 +90,27 @@ Use the right tool for the job:
 - **History/evolution** (when added, who changed): git commands
 
 Flood with parallel calls. Cross-validate findings across multiple tools.
+
+
+<anti-hallucination-guardrails>
+## Anti-Hallucination Rules (MANDATORY)
+
+These rules are NON-NEGOTIABLE. Violating them is a critical failure.
+
+### Rule 1: No Fake Tool Calls
+- If you claim "I read the file", "I checked the code", "I confirmed in the source" — there MUST be a corresponding tool call (read, exec, grep, etc.) in THE SAME turn.
+- If you did NOT make a tool call, say: "I have not verified this directly — this is based on prior knowledge/context."
+
+### Rule 2: No Fabricated Results
+- Never invent file contents, command outputs, or API responses.
+- If unsure what a file contains, READ IT first.
+
+### Rule 3: Distinguish Memory from Verification
+- Prior sessions/context = "이전 세션 기억 기반으로는..." / "Based on prior context..."
+- This session tool calls = state directly
+- NEVER present memory as if you just verified it.
+
+### Rule 4: Sub-agent Delegation Honesty
+- If asked to delegate, you MUST actually call sessions_spawn or omoc_delegate.
+- Claiming "완료" without a tool call = CRITICAL VIOLATION.
+</anti-hallucination-guardrails>

package/agents/frontend.md

@@ -57,3 +57,27 @@ After every UI change:
 - **DO**: Frontend code, styles, animations, layout, accessibility, responsive design
 - **DO NOT**: Backend logic, database changes, API design, infrastructure
 - **ESCALATE**: Design system creation (needs architect approval), major UX flows (needs product input)
+
+
+<anti-hallucination-guardrails>
+## Anti-Hallucination Rules (MANDATORY)
+
+These rules are NON-NEGOTIABLE. Violating them is a critical failure.
+
+### Rule 1: No Fake Tool Calls
+- If you claim "I read the file", "I checked the code", "I confirmed in the source" — there MUST be a corresponding tool call (read, exec, grep, etc.) in THE SAME turn.
+- If you did NOT make a tool call, say: "I have not verified this directly — this is based on prior knowledge/context."
+
+### Rule 2: No Fabricated Results
+- Never invent file contents, command outputs, or API responses.
+- If unsure what a file contains, READ IT first.
+
+### Rule 3: Distinguish Memory from Verification
+- Prior sessions/context = "이전 세션 기억 기반으로는..." / "Based on prior context..."
+- This session tool calls = state directly
+- NEVER present memory as if you just verified it.
+
+### Rule 4: Sub-agent Delegation Honesty
+- If asked to delegate, you MUST actually call sessions_spawn or omoc_delegate.
+- Claiming "완료" without a tool call = CRITICAL VIOLATION.
+</anti-hallucination-guardrails>

package/agents/hephaestus.md

@@ -412,3 +412,27 @@ This means:
    - If Oracle fails → ASK USER with clear explanation
 
 **Never**: Leave code broken, delete failing tests, shotgun debug
+
+
+<anti-hallucination-guardrails>
+## Anti-Hallucination Rules (MANDATORY)
+
+These rules are NON-NEGOTIABLE. Violating them is a critical failure.
+
+### Rule 1: No Fake Tool Calls
+- If you claim "I read the file", "I checked the code", "I confirmed in the source" — there MUST be a corresponding tool call (read, exec, grep, etc.) in THE SAME turn.
+- If you did NOT make a tool call, say: "I have not verified this directly — this is based on prior knowledge/context."
+
+### Rule 2: No Fabricated Results
+- Never invent file contents, command outputs, or API responses.
+- If unsure what a file contains, READ IT first.
+
+### Rule 3: Distinguish Memory from Verification
+- Prior sessions/context = "이전 세션 기억 기반으로는..." / "Based on prior context..."
+- This session tool calls = state directly
+- NEVER present memory as if you just verified it.
+
+### Rule 4: Sub-agent Delegation Honesty
+- If asked to delegate, you MUST actually call sessions_spawn or omoc_delegate.
+- Claiming "완료" without a tool call = CRITICAL VIOLATION.
+</anti-hallucination-guardrails>

package/agents/librarian.md

@@ -289,3 +289,27 @@ grep_app_searchGitHub(query: "useQuery")
 3. **ALWAYS CITE**: Every code claim needs a permalink
 4. **USE MARKDOWN**: Code blocks with language identifiers
 5. **BE CONCISE**: Facts > opinions, evidence > speculation
+
+
+<anti-hallucination-guardrails>
+## Anti-Hallucination Rules (MANDATORY)
+
+These rules are NON-NEGOTIABLE. Violating them is a critical failure.
+
+### Rule 1: No Fake Tool Calls
+- If you claim "I read the file", "I checked the code", "I confirmed in the source" — there MUST be a corresponding tool call (read, exec, grep, etc.) in THE SAME turn.
+- If you did NOT make a tool call, say: "I have not verified this directly — this is based on prior knowledge/context."
+
+### Rule 2: No Fabricated Results
+- Never invent file contents, command outputs, or API responses.
+- If unsure what a file contains, READ IT first.
+
+### Rule 3: Distinguish Memory from Verification
+- Prior sessions/context = "이전 세션 기억 기반으로는..." / "Based on prior context..."
+- This session tool calls = state directly
+- NEVER present memory as if you just verified it.
+
+### Rule 4: Sub-agent Delegation Honesty
+- If asked to delegate, you MUST actually call sessions_spawn or omoc_delegate.
+- Claiming "완료" without a tool call = CRITICAL VIOLATION.
+</anti-hallucination-guardrails>

package/agents/metis.md

@@ -290,3 +290,27 @@ User confirms the button works as expected.
 - Provide actionable directives for Prometheus
 - Include QA automation directives in every output
 - Ensure acceptance criteria are agent-executable (commands, not human actions)
+
+
+<anti-hallucination-guardrails>
+## Anti-Hallucination Rules (MANDATORY)
+
+These rules are NON-NEGOTIABLE. Violating them is a critical failure.
+
+### Rule 1: No Fake Tool Calls
+- If you claim "I read the file", "I checked the code", "I confirmed in the source" — there MUST be a corresponding tool call (read, exec, grep, etc.) in THE SAME turn.
+- If you did NOT make a tool call, say: "I have not verified this directly — this is based on prior knowledge/context."
+
+### Rule 2: No Fabricated Results
+- Never invent file contents, command outputs, or API responses.
+- If unsure what a file contains, READ IT first.
+
+### Rule 3: Distinguish Memory from Verification
+- Prior sessions/context = "이전 세션 기억 기반으로는..." / "Based on prior context..."
+- This session tool calls = state directly
+- NEVER present memory as if you just verified it.
+
+### Rule 4: Sub-agent Delegation Honesty
+- If asked to delegate, you MUST actually call sessions_spawn or omoc_delegate.
+- Claiming "완료" without a tool call = CRITICAL VIOLATION.
+</anti-hallucination-guardrails>

package/agents/momus.md

@@ -179,3 +179,27 @@ If REJECT:
 **Your job is to UNBLOCK work, not to BLOCK it with perfectionism.**
 
 **Response Language**: Match the language of the plan content.
+
+
+<anti-hallucination-guardrails>
+## Anti-Hallucination Rules (MANDATORY)
+
+These rules are NON-NEGOTIABLE. Violating them is a critical failure.
+
+### Rule 1: No Fake Tool Calls
+- If you claim "I read the file", "I checked the code", "I confirmed in the source" — there MUST be a corresponding tool call (read, exec, grep, etc.) in THE SAME turn.
+- If you did NOT make a tool call, say: "I have not verified this directly — this is based on prior knowledge/context."
+
+### Rule 2: No Fabricated Results
+- Never invent file contents, command outputs, or API responses.
+- If unsure what a file contains, READ IT first.
+
+### Rule 3: Distinguish Memory from Verification
+- Prior sessions/context = "이전 세션 기억 기반으로는..." / "Based on prior context..."
+- This session tool calls = state directly
+- NEVER present memory as if you just verified it.
+
+### Rule 4: Sub-agent Delegation Honesty
+- If asked to delegate, you MUST actually call sessions_spawn or omoc_delegate.
+- Claiming "완료" without a tool call = CRITICAL VIOLATION.
+</anti-hallucination-guardrails>

package/agents/multimodal-looker.md

@@ -35,3 +35,27 @@ Response rules:
 - Be thorough on the goal, concise on everything else
 
 Your output goes straight to the main agent for continued work.
+
+
+<anti-hallucination-guardrails>
+## Anti-Hallucination Rules (MANDATORY)
+
+These rules are NON-NEGOTIABLE. Violating them is a critical failure.
+
+### Rule 1: No Fake Tool Calls
+- If you claim "I read the file", "I checked the code", "I confirmed in the source" — there MUST be a corresponding tool call (read, exec, grep, etc.) in THE SAME turn.
+- If you did NOT make a tool call, say: "I have not verified this directly — this is based on prior knowledge/context."
+
+### Rule 2: No Fabricated Results
+- Never invent file contents, command outputs, or API responses.
+- If unsure what a file contains, READ IT first.
+
+### Rule 3: Distinguish Memory from Verification
+- Prior sessions/context = "이전 세션 기억 기반으로는..." / "Based on prior context..."
+- This session tool calls = state directly
+- NEVER present memory as if you just verified it.
+
+### Rule 4: Sub-agent Delegation Honesty
+- If asked to delegate, you MUST actually call sessions_spawn or omoc_delegate.
+- Claiming "완료" without a tool call = CRITICAL VIOLATION.
+</anti-hallucination-guardrails>

package/agents/oracle.md

@@ -123,3 +123,27 @@ Before finalizing answers on architecture, security, or performance:
 <delivery>
 Your response goes directly to the user with no intermediate processing. Make your final message self-contained: a clear recommendation they can act on immediately, covering both what to do and why.
 </delivery>
+
+
+<anti-hallucination-guardrails>
+## Anti-Hallucination Rules (MANDATORY)
+
+These rules are NON-NEGOTIABLE. Violating them is a critical failure.
+
+### Rule 1: No Fake Tool Calls
+- If you claim "I read the file", "I checked the code", "I confirmed in the source" — there MUST be a corresponding tool call (read, exec, grep, etc.) in THE SAME turn.
+- If you did NOT make a tool call, say: "I have not verified this directly — this is based on prior knowledge/context."
+
+### Rule 2: No Fabricated Results
+- Never invent file contents, command outputs, or API responses.
+- If unsure what a file contains, READ IT first.
+
+### Rule 3: Distinguish Memory from Verification
+- Prior sessions/context = "이전 세션 기억 기반으로는..." / "Based on prior context..."
+- This session tool calls = state directly
+- NEVER present memory as if you just verified it.
+
+### Rule 4: Sub-agent Delegation Honesty
+- If asked to delegate, you MUST actually call sessions_spawn or omoc_delegate.
+- Claiming "완료" without a tool call = CRITICAL VIOLATION.
+</anti-hallucination-guardrails>

package/agents/prometheus.md

@@ -1358,3 +1358,27 @@ This will:
 
 **This constraint is SYSTEM-LEVEL. It cannot be overridden by user requests.**
 </system-reminder>
+
+
+<anti-hallucination-guardrails>
+## Anti-Hallucination Rules (MANDATORY)
+
+These rules are NON-NEGOTIABLE. Violating them is a critical failure.
+
+### Rule 1: No Fake Tool Calls
+- If you claim "I read the file", "I checked the code", "I confirmed in the source" — there MUST be a corresponding tool call (read, exec, grep, etc.) in THE SAME turn.
+- If you did NOT make a tool call, say: "I have not verified this directly — this is based on prior knowledge/context."
+
+### Rule 2: No Fabricated Results
+- Never invent file contents, command outputs, or API responses.
+- If unsure what a file contains, READ IT first.
+
+### Rule 3: Distinguish Memory from Verification
+- Prior sessions/context = "이전 세션 기억 기반으로는..." / "Based on prior context..."
+- This session tool calls = state directly
+- NEVER present memory as if you just verified it.
+
+### Rule 4: Sub-agent Delegation Honesty
+- If asked to delegate, you MUST actually call sessions_spawn or omoc_delegate.
+- Claiming "완료" without a tool call = CRITICAL VIOLATION.
+</anti-hallucination-guardrails>

package/agents/sisyphus-junior.md

@@ -32,3 +32,27 @@ Task NOT complete without:
 - Match user's communication style.
 - Dense > verbose.
 </Style>
+
+
+<anti-hallucination-guardrails>
+## Anti-Hallucination Rules (MANDATORY)
+
+These rules are NON-NEGOTIABLE. Violating them is a critical failure.
+
+### Rule 1: No Fake Tool Calls
+- If you claim "I read the file", "I checked the code", "I confirmed in the source" — there MUST be a corresponding tool call (read, exec, grep, etc.) in THE SAME turn.
+- If you did NOT make a tool call, say: "I have not verified this directly — this is based on prior knowledge/context."
+
+### Rule 2: No Fabricated Results
+- Never invent file contents, command outputs, or API responses.
+- If unsure what a file contains, READ IT first.
+
+### Rule 3: Distinguish Memory from Verification
+- Prior sessions/context = "이전 세션 기억 기반으로는..." / "Based on prior context..."
+- This session tool calls = state directly
+- NEVER present memory as if you just verified it.
+
+### Rule 4: Sub-agent Delegation Honesty
+- If asked to delegate, you MUST actually call sessions_spawn or omoc_delegate.
+- Claiming "완료" without a tool call = CRITICAL VIOLATION.
+</anti-hallucination-guardrails>

package/dist/hooks/subagent-tracker.js

@@ -1,5 +1,5 @@
 import { LOG_PREFIX } from '../constants.js';
-import { trackSubagentSpawn, clearSubagentTracking } from '../services/webhook-bridge.js';
+import { trackSubagentSpawn, clearSubagentTracking, getCallerSessionKey, getTrackedSubagents } from '../services/webhook-bridge.js';
 import { callHooksWake } from '../utils/webhook-client.js';
 import { getConfig } from '../utils/config.js';
 const SPAWN_TOOL_NAME = 'sessions_spawn';
@@ -27,6 +27,43 @@ function extractSpawnResult(content) {
     }
     return null;
 }
+/**
+ * Tries to find a tracked sub-agent from the message content.
+ * Uses multiple strategies: runId match, childSessionKey match.
+ * Falls back to keyword detection for single-tracked-agent case
+ * only when multiple strong announce indicators are present.
+ */
+function findTrackedSubagentInContent(content) {
+    const tracked = getTrackedSubagents();
+    if (tracked.size === 0)
+        return null;
+    // Strategy 1: Direct runId match in content
+    const runIdMatch = content.match(/runId["\s:=]+["']?([a-zA-Z0-9_-]+)/);
+    if (runIdMatch && tracked.has(runIdMatch[1])) {
+        return runIdMatch[1];
+    }
+    // Strategy 2: childSessionKey match in content
+    for (const [runId, entry] of tracked) {
+        if (content.includes(entry.childSessionKey)) {
+            return runId;
+        }
+    }
+    // Strategy 3: Strong announce indicators (require at least 2)
+    // Only used for unambiguous single-tracked-agent case
+    if (tracked.size === 1) {
+        const strongIndicators = [
+            'Sub-agent', 'subagent', 'sub_agent',
+            'Result:', 'Summary:',
+        ];
+        const matchCount = strongIndicators.filter((kw) => content.includes(kw)).length;
+        // Require at least 2 strong indicators to avoid false positives
+        if (matchCount >= 2) {
+            const [onlyRunId] = tracked.keys();
+            return onlyRunId;
+        }
+    }
+    return null;
+}
 export function registerSubagentTracker(api) {
     api.registerHook('tool_result_persist', (payload) => {
         if (payload.tool !== SPAWN_TOOL_NAME)
@@ -34,43 +71,78 @@ export function registerSubagentTracker(api) {
         const content = typeof payload.content === 'string' ? payload.content : '';
         const spawnResult = extractSpawnResult(content);
         if (spawnResult) {
+            const callerSessionKey = typeof payload.sessionId === 'string'
+                ? payload.sessionId
+                : undefined;
             trackSubagentSpawn({
                 ...spawnResult,
                 spawnedAt: Date.now(),
+                callerSessionKey,
             });
-            api.logger.info(`${LOG_PREFIX} Tracking sub-agent spawn: runId=${spawnResult.runId}`);
+            api.logger.info(`${LOG_PREFIX} Tracking sub-agent spawn: runId=${spawnResult.runId}, callerSession=${callerSessionKey ?? 'unknown'}`);
         }
         return undefined;
     }, {
         name: 'oh-my-openclaw.subagent-tracker',
         description: 'Tracks sessions_spawn results for stale sub-agent detection',
     });
+    api.on('subagent_ended', async (event, ctx) => {
+        const runId = typeof event?.runId === 'string' ? event.runId : undefined;
+        if (!runId)
+            return;
+        const tracked = getTrackedSubagents();
+        const wasTracked = tracked.has(runId);
+        const callerSession = getCallerSessionKey(runId);
+        clearSubagentTracking(runId);
+        if (!wasTracked)
+            return;
+        api.logger.info(`${LOG_PREFIX} subagent_ended received: runId=${runId} (callerSession=${callerSession ?? 'unknown'})`);
+        const config = getConfig(api);
+        if (config.webhook_bridge_enabled && config.gateway_url && config.hooks_token) {
+            const requesterSessionKey = typeof ctx?.requesterSessionKey === 'string'
+                ? (ctx.requesterSessionKey)
+                : undefined;
+            const wakeMessage = requesterSessionKey
+                ? `[System] Sub-agent completed (runId=${runId}, requester=${requesterSessionKey}). Process the result and continue pending work.`
+                : `[System] Sub-agent completed (runId=${runId}). Process the result and continue pending work.`;
+            const result = await callHooksWake(wakeMessage, { gateway_url: config.gateway_url, hooks_token: config.hooks_token }, api.logger);
+            if (result.ok) {
+                api.logger.info(`${LOG_PREFIX} Wake sent from subagent_ended: runId=${runId}`);
+            }
+            else {
+                api.logger.warn(`${LOG_PREFIX} Wake from subagent_ended failed: ${result.error ?? `status ${result.status}`}`);
+            }
+        }
+    }, { priority: 120 });
     api.registerHook('message:received', (context) => {
         const content = context?.content ?? '';
-        if (!content.includes('Sub-agent') && !content.includes('subagent') && !content.includes('announce')) {
+        // Skip empty/short messages
+        if (content.length < 10)
             return undefined;
-        }
-        const runIdMatch = content.match(/runId["\s:=]+["']?([a-zA-Z0-9_-]+)/);
-        if (runIdMatch) {
-            clearSubagentTracking(runIdMatch[1]);
-            api.logger.info(`${LOG_PREFIX} Cleared sub-agent tracking: runId=${runIdMatch[1]} (announce received)`);
-            // Send wake to ensure the main agent processes the announce and continues work
-            const config = getConfig(api);
-            if (config.webhook_bridge_enabled && config.gateway_url && config.hooks_token) {
-                void callHooksWake(`[System] Sub-agent completed (runId=${runIdMatch[1]}). Process the announce result and continue any pending work.`, { gateway_url: config.gateway_url, hooks_token: config.hooks_token }, api.logger).then((result) => {
-                    if (result.ok) {
-                        api.logger.info(`${LOG_PREFIX} Wake sent after sub-agent announce: runId=${runIdMatch[1]}`);
-                    }
-                    else {
-                        api.logger.warn(`${LOG_PREFIX} Wake after announce failed: ${result.error ?? `status ${result.status}`}`);
-                    }
-                });
-            }
+        // Try to find a tracked sub-agent in this message
+        const matchedRunId = findTrackedSubagentInContent(content);
+        if (!matchedRunId)
+            return undefined;
+        // Found a match — this is likely a sub-agent announce
+        const callerSession = getCallerSessionKey(matchedRunId);
+        clearSubagentTracking(matchedRunId);
+        api.logger.info(`${LOG_PREFIX} Sub-agent announce detected: runId=${matchedRunId} (callerSession=${callerSession ?? 'unknown'})`);
+        // Send wake to ensure the main agent processes the announce and continues work
+        const config = getConfig(api);
+        if (config.webhook_bridge_enabled && config.gateway_url && config.hooks_token) {
+            void callHooksWake(`[System] Sub-agent completed (runId=${matchedRunId}). Process the announce result and continue any pending work.`, { gateway_url: config.gateway_url, hooks_token: config.hooks_token }, api.logger).then((result) => {
+                if (result.ok) {
+                    api.logger.info(`${LOG_PREFIX} Wake sent after sub-agent announce: runId=${matchedRunId}`);
+                }
+                else {
+                    api.logger.warn(`${LOG_PREFIX} Wake after announce failed: ${result.error ?? `status ${result.status}`}`);
+                }
+            });
         }
         return undefined;
     }, {
         name: 'oh-my-openclaw.subagent-announce-detector',
-        description: 'Detects sub-agent announce messages, clears stale tracking, and wakes main agent',
+        description: 'Detects sub-agent announce messages via multi-strategy matching, clears stale tracking, and wakes main agent',
     });
 }
 export { extractSpawnResult };

package/dist/services/webhook-bridge.d.ts

@@ -4,10 +4,14 @@ interface TrackedSubagent {
     childSessionKey: string;
     task: string;
     spawnedAt: number;
+    /** Session key of the agent that spawned this sub-agent */
+    callerSessionKey?: string;
 }
 export declare function trackSubagentSpawn(entry: TrackedSubagent): void;
 export declare function clearSubagentTracking(runId: string): void;
 export declare function getTrackedSubagents(): ReadonlyMap<string, TrackedSubagent>;
+/** Get the caller session key for a tracked sub-agent */
+export declare function getCallerSessionKey(runId: string): string | undefined;
 export declare function resetWebhookBridgeState(): void;
 export declare function registerWebhookBridge(api: OmocPluginApi): void;
 export {};

package/dist/services/webhook-bridge.js

@@ -13,6 +13,10 @@ export function clearSubagentTracking(runId) {
 export function getTrackedSubagents() {
     return trackedSubagents;
 }
+/** Get the caller session key for a tracked sub-agent */
+export function getCallerSessionKey(runId) {
+    return trackedSubagents.get(runId)?.callerSessionKey;
+}
 export function resetWebhookBridgeState() {
     trackedSubagents.clear();
     if (reminderTimer) {
@@ -33,12 +37,19 @@ async function checkIncompleteTodos(api) {
     const allSessionKeys = ['__default__', 'agent:main:main'];
     let totalIncomplete = 0;
     const summaryParts = [];
+    // Collect owner session keys from incomplete todos for targeted delivery
+    const ownerSessionKeys = new Set();
     for (const sessionKey of allSessionKeys) {
         const incomplete = getIncompleteTodos(sessionKey);
         if (incomplete.length > 0) {
             totalIncomplete += incomplete.length;
             const items = incomplete.map((t) => `  - [${t.status}] ${t.content}`).join('\n');
             summaryParts.push(items);
+            for (const todo of incomplete) {
+                if (todo.ownerSessionKey) {
+                    ownerSessionKeys.add(todo.ownerSessionKey);
+                }
+            }
         }
     }
     if (totalIncomplete === 0)
@@ -47,12 +58,17 @@ async function checkIncompleteTodos(api) {
     const message = `[OmOC Periodic Reminder] You have ${totalIncomplete} incomplete todo(s):\n${summary}\n\n` +
         `Review with \`${TOOL_PREFIX}todo_list\` and resume work. ` +
         `If blocked, update todo status. If all done, mark them complete.`;
+    // If we have owner session keys, send to the first one; otherwise fallback to default
+    const targetSessionKey = ownerSessionKeys.size > 0
+        ? [...ownerSessionKeys][0]
+        : undefined;
     const result = await callHooksAgent(message, webhookConfig, {
         name: 'OmOC-TodoReminder',
         deliver: false,
+        ...(targetSessionKey ? { sessionKey: targetSessionKey } : {}),
     }, api.logger);
     if (result.ok) {
-        api.logger.info(`${LOG_PREFIX} Periodic todo reminder sent via hooks/agent (${totalIncomplete} incomplete)`);
+        api.logger.info(`${LOG_PREFIX} Periodic todo reminder sent via hooks/agent (${totalIncomplete} incomplete, target=${targetSessionKey ?? 'default'})`);
     }
 }
 async function checkStaleSubagents(api) {

package/dist/tools/todo/store.d.ts

@@ -6,6 +6,8 @@ export interface TodoItem {
     status: TodoStatus;
     priority: TodoPriority;
     createdAt: string;
+    /** Session key that created/owns this todo */
+    ownerSessionKey?: string;
 }
 interface SessionStore {
     todos: TodoItem[];
@@ -13,7 +15,7 @@ interface SessionStore {
 }
 declare const DEFAULT_SESSION = "__default__";
 declare const sessions: Map<string, SessionStore>;
-export declare function createTodo(content: string, priority?: TodoPriority, status?: TodoStatus, sessionKey?: string): TodoItem;
+export declare function createTodo(content: string, priority?: TodoPriority, status?: TodoStatus, sessionKey?: string, ownerSessionKey?: string): TodoItem;
 export declare function listTodos(statusFilter?: TodoStatus, sessionKey?: string): ReadonlyArray<TodoItem>;
 export declare function findTodo(id: string, sessionKey?: string): TodoItem | undefined;
 export declare function updateTodo(id: string, updates: Partial<Pick<TodoItem, 'status' | 'priority' | 'content'>>, sessionKey?: string): TodoItem | null;

package/dist/tools/todo/store.js

@@ -9,7 +9,7 @@ function getSession(sessionKey) {
     }
     return store;
 }
-export function createTodo(content, priority = 'medium', status = 'pending', sessionKey) {
+export function createTodo(content, priority = 'medium', status = 'pending', sessionKey, ownerSessionKey) {
     const store = getSession(sessionKey);
     const item = {
         id: `todo-${store.nextId++}`,
@@ -17,6 +17,7 @@ export function createTodo(content, priority = 'medium', status = 'pending', ses
         status,
         priority,
         createdAt: new Date().toISOString(),
+        ownerSessionKey: ownerSessionKey ?? sessionKey,
     };
     store.todos.push(item);
     return item;

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "oh-my-openclaw",
   "name": "Oh-My-OpenClaw",
   "description": "Multi-agent orchestration plugin — 11 agents, category-based model routing, todo enforcer, ralph loop, agent setup CLI, and custom tools",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "skills": [
     "skills"
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happycastle/oh-my-openclaw",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "description": "Oh-My-OpenClaw plugin — multi-agent orchestration, todo enforcer, ralph loop, and custom tools for OpenClaw",
   "type": "module",
   "main": "dist/index.js",