@happycastle/oh-my-openclaw 0.17.0 → 0.18.0

package/dist/hooks/guardrail-injector.d.ts

@@ -0,0 +1,2 @@
+import { OmocPluginApi } from '../types.js';
+export declare function registerGuardrailInjector(api: OmocPluginApi): void;

package/dist/hooks/guardrail-injector.js

@@ -0,0 +1,37 @@
+import { LOG_PREFIX } from '../constants.js';
+const GUARDRAIL_RULES = `
+<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 say "I read the file", "I checked the code", "I confirmed in the source", or similar — there MUST be a corresponding \`read\`, \`exec\`, \`grep\`, or equivalent tool call in THE SAME turn.
+- If you did NOT make a tool call, you MUST say: "I haven't verified this directly — this is based on my prior knowledge/context."
+- Phrases that REQUIRE a preceding tool call: "확인했다", "읽었다", "봤다", "코드에서", "소스를 보면", "파일을 열어보니", "checked", "verified", "confirmed", "read the file", "looked at the code"
+
+### Rule 2: No Fabricated Results
+- Never invent file contents, command outputs, or API responses.
+- If you're unsure what a file contains, READ IT. Don't guess.
+- If a tool call fails, report the failure — don't make up what the result "would have been."
+
+### Rule 3: Distinguish Memory from Verification
+- Information from previous sessions or context = "이전 세션 기억 기반으로는..." or "Based on prior context..."
+- Information from THIS session's tool calls = state it directly
+- NEVER present memory/context as if you just verified it with a tool call.
+
+### Rule 4: Sub-agent Delegation Honesty
+- If asked to delegate to a sub-agent, you MUST actually call \`sessions_spawn\` or \`omoc_delegate\`.
+- Saying "서브에이전트 호출 완료" without a tool call = CRITICAL VIOLATION.
+- If the spawn fails, report the failure honestly.
+</anti-hallucination-guardrails>
+`.trim();
+export function registerGuardrailInjector(api) {
+    api.on('before_prompt_build', (_event, _ctx) => {
+        api.logger.info(`${LOG_PREFIX} Guardrail rules injected via before_prompt_build`);
+        return {
+            prependContext: GUARDRAIL_RULES,
+        };
+    }, { priority: 90 } // Between persona (100) and context-injector (50)
+    );
+}

package/dist/hooks/subagent-tracker.js

@@ -1,5 +1,7 @@
 import { LOG_PREFIX } from '../constants.js';
 import { trackSubagentSpawn, clearSubagentTracking } from '../services/webhook-bridge.js';
+import { callHooksWake } from '../utils/webhook-client.js';
+import { getConfig } from '../utils/config.js';
 const SPAWN_TOOL_NAME = 'sessions_spawn';
 function extractSpawnResult(content) {
     try {
@@ -52,11 +54,23 @@ export function registerSubagentTracker(api) {
         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}`}`);
+                    }
+                });
+            }
         }
         return undefined;
     }, {
         name: 'oh-my-openclaw.subagent-announce-detector',
-        description: 'Detects sub-agent announce messages and clears stale tracking',
+        description: 'Detects sub-agent announce messages, clears stale tracking, and wakes main agent',
     });
 }
 export { extractSpawnResult };

package/dist/index.js

@@ -18,6 +18,7 @@ import { registerRalphCommands } from './commands/ralph-commands.js';
 import { registerStatusCommands } from './commands/status-commands.js';
 import { registerPersonaCommands } from './commands/persona-commands.js';
 import { registerContextInjector } from './hooks/context-injector.js';
+import { registerGuardrailInjector } from './hooks/guardrail-injector.js';
 import { registerSessionSync } from './hooks/session-sync.js';
 import { registerSpawnGuard } from './hooks/spawn-guard.js';
 import { registerKeywordDetector } from './hooks/keyword-detector/hook.js';
@@ -95,6 +96,11 @@ export default function register(api) {
         registry.hooks.push('context-injector');
         api.logger.info(`[${PLUGIN_ID}] Context injector hook registered (before_prompt_build)`);
     });
+    safeRegister(api, 'guardrail-injector', 'hook', () => {
+        registerGuardrailInjector(guarded);
+        registry.hooks.push('guardrail-injector');
+        api.logger.info(`[${PLUGIN_ID}] Guardrail injector hook registered (before_prompt_build, priority 90)`);
+    });
     safeRegister(api, 'session-sync', 'hook', () => {
         registerSessionSync(api);
         registry.hooks.push('session-sync');

package/dist/services/ralph-loop.js

@@ -62,8 +62,6 @@ export function registerRalphLoop(api) {
     stateFilePath = join(config.checkpoint_dir, 'ralph-loop-state.json');
     api.registerService({
         id: 'omoc-ralph-loop',
-        name: 'Ralph Loop Service',
-        description: 'Self-referential completion mechanism with configurable iterations',
         start: async () => {
             await loadStateFromFile();
         },

package/dist/services/webhook-bridge.js

@@ -86,8 +86,6 @@ export function registerWebhookBridge(api) {
     const config = getConfig(api);
     api.registerService({
         id: 'omoc-webhook-bridge',
-        name: 'Webhook Bridge Service',
-        description: 'Proactive agent messaging via Gateway webhook hooks',
         start: async () => {
             if (!config.webhook_bridge_enabled) {
                 api.logger.info(`${LOG_PREFIX} Webhook bridge disabled (set webhook_bridge_enabled: true to enable)`);

package/dist/types.d.ts

@@ -72,12 +72,21 @@ export interface CommandRegistration<TCtx = {
         text: string;
     }>;
 }
+export interface ServiceContext {
+    config: unknown;
+    workspaceDir?: string;
+    stateDir: string;
+    logger: {
+        info: (message: string) => void;
+        warn: (message: string) => void;
+        error: (message: string) => void;
+        debug?: (message: string) => void;
+    };
+}
 export interface ServiceRegistration {
     id: string;
-    name: string;
-    description?: string;
-    start?: () => Promise<void>;
-    stop?: () => Promise<void>;
+    start: (ctx: ServiceContext) => void | Promise<void>;
+    stop?: (ctx: ServiceContext) => void | Promise<void>;
 }
 export interface OmocPluginApi {
     pluginConfig?: PluginConfig;

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.17.0",
+  "version": "0.18.0",
   "skills": [
     "skills"
   ],

package/package.json

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