claudecode-omc 4.3.4

package/dist/hooks/__tests__/compaction-concurrency.test.js

@@ -0,0 +1,313 @@
+/**
+ * Tests for issue #453: Compaction error when subagent tasks flood in simultaneously.
+ *
+ * Verifies:
+ * 1. Concurrent processPreCompact calls are serialized via mutex
+ * 2. Rapid-fire postToolUse calls are debounced
+ * 3. Queued callers receive the correct result
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { mkdtempSync, mkdirSync, existsSync, rmSync, readdirSync } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { processPreCompact, isCompactionInProgress, getCompactionQueueDepth, } from '../pre-compact/index.js';
+import { createPreemptiveCompactionHook, resetSessionTokenEstimate, clearRapidFireDebounce, RAPID_FIRE_DEBOUNCE_MS, getSessionTokenEstimate, } from '../preemptive-compaction/index.js';
+// ============================================================================
+// Helpers
+// ============================================================================
+function createTempDir() {
+    const dir = mkdtempSync(join(tmpdir(), 'compaction-test-'));
+    mkdirSync(join(dir, '.omc', 'state'), { recursive: true });
+    return dir;
+}
+function makePreCompactInput(cwd, trigger = 'auto') {
+    return {
+        session_id: 'test-session',
+        transcript_path: join(cwd, 'transcript.json'),
+        cwd,
+        permission_mode: 'default',
+        hook_event_name: 'PreCompact',
+        trigger,
+    };
+}
+// ============================================================================
+// Pre-Compact Mutex Tests
+// ============================================================================
+describe('processPreCompact - Compaction Mutex (issue #453)', () => {
+    let tempDir;
+    beforeEach(() => {
+        tempDir = createTempDir();
+    });
+    afterEach(() => {
+        try {
+            rmSync(tempDir, { recursive: true, force: true });
+        }
+        catch { /* ignore cleanup errors */ }
+    });
+    it('should complete successfully for a single call', async () => {
+        const input = makePreCompactInput(tempDir);
+        const result = await processPreCompact(input);
+        expect(result.continue).toBe(true);
+        expect(result.systemMessage).toBeDefined();
+        expect(result.systemMessage).toContain('PreCompact Checkpoint');
+    });
+    it('should serialize concurrent calls for the same directory', async () => {
+        const input = makePreCompactInput(tempDir);
+        // Fire 5 concurrent compaction requests (simulates swarm/ultrawork)
+        const promises = Array.from({ length: 5 }, () => processPreCompact(input));
+        const results = await Promise.all(promises);
+        // All should succeed
+        for (const result of results) {
+            expect(result.continue).toBe(true);
+            expect(result.systemMessage).toBeDefined();
+        }
+        // All should receive the same result (coalesced)
+        const firstMessage = results[0].systemMessage;
+        for (const result of results) {
+            expect(result.systemMessage).toBe(firstMessage);
+        }
+    });
+    it('should only create one checkpoint file per coalesced batch', async () => {
+        const input = makePreCompactInput(tempDir);
+        // Fire concurrent requests
+        await Promise.all(Array.from({ length: 3 }, () => processPreCompact(input)));
+        // Check checkpoint directory
+        const checkpointDir = join(tempDir, '.omc', 'state', 'checkpoints');
+        if (existsSync(checkpointDir)) {
+            const files = readdirSync(checkpointDir).filter(f => f.startsWith('checkpoint-'));
+            // Should have exactly 1 checkpoint (not 3)
+            expect(files.length).toBe(1);
+        }
+    });
+    it('should not report in-progress after completion', async () => {
+        const input = makePreCompactInput(tempDir);
+        expect(isCompactionInProgress(tempDir)).toBe(false);
+        await processPreCompact(input);
+        expect(isCompactionInProgress(tempDir)).toBe(false);
+        expect(getCompactionQueueDepth(tempDir)).toBe(0);
+    });
+    it('should allow sequential compactions for the same directory', async () => {
+        const input = makePreCompactInput(tempDir);
+        const result1 = await processPreCompact(input);
+        const result2 = await processPreCompact(input);
+        // Both should succeed independently
+        expect(result1.continue).toBe(true);
+        expect(result2.continue).toBe(true);
+        // Second call runs fresh (not coalesced) — verify at least 1 checkpoint exists.
+        // Note: both calls may produce the same millisecond timestamp, causing the
+        // second writeFileSync to overwrite the first (same filename). This is expected
+        // behavior — the important assertion is that both calls succeed independently.
+        const checkpointDir = join(tempDir, '.omc', 'state', 'checkpoints');
+        if (existsSync(checkpointDir)) {
+            const files = readdirSync(checkpointDir).filter(f => f.startsWith('checkpoint-'));
+            expect(files.length).toBeGreaterThanOrEqual(1);
+        }
+    });
+    it('should handle concurrent calls for different directories independently', async () => {
+        const tempDir2 = createTempDir();
+        try {
+            const input1 = makePreCompactInput(tempDir);
+            const input2 = makePreCompactInput(tempDir2);
+            // Fire concurrent requests for different directories
+            const [result1, result2] = await Promise.all([
+                processPreCompact(input1),
+                processPreCompact(input2),
+            ]);
+            // Both should succeed
+            expect(result1.continue).toBe(true);
+            expect(result2.continue).toBe(true);
+            // Each directory should have its own checkpoint
+            const checkpointDir1 = join(tempDir, '.omc', 'state', 'checkpoints');
+            const checkpointDir2 = join(tempDir2, '.omc', 'state', 'checkpoints');
+            if (existsSync(checkpointDir1)) {
+                const files1 = readdirSync(checkpointDir1).filter(f => f.startsWith('checkpoint-'));
+                expect(files1.length).toBe(1);
+            }
+            if (existsSync(checkpointDir2)) {
+                const files2 = readdirSync(checkpointDir2).filter(f => f.startsWith('checkpoint-'));
+                expect(files2.length).toBe(1);
+            }
+        }
+        finally {
+            rmSync(tempDir2, { recursive: true, force: true });
+        }
+    });
+    it('should propagate rejection to all coalesced callers and clear mutex', async () => {
+        // Use a nonexistent directory to trigger an error in doProcessPreCompact
+        const badDir = '/tmp/nonexistent-compaction-dir-' + Date.now();
+        const input = makePreCompactInput(badDir);
+        // Fire 3 concurrent calls sharing the same in-flight promise
+        const results = await Promise.allSettled(Array.from({ length: 3 }, () => processPreCompact(input)));
+        // All should either reject or return an error-like result
+        // processPreCompact may catch internally and return a result rather than throwing
+        for (const result of results) {
+            if (result.status === 'rejected') {
+                expect(result.reason).toBeDefined();
+            }
+            else {
+                // If it doesn't throw, at minimum it should still complete
+                expect(result.value).toBeDefined();
+            }
+        }
+        // Mutex state should be cleared regardless
+        expect(isCompactionInProgress(badDir)).toBe(false);
+        expect(getCompactionQueueDepth(badDir)).toBe(0);
+    });
+});
+// ============================================================================
+// Preemptive Compaction Rapid-Fire Debounce Tests
+// ============================================================================
+describe('createPreemptiveCompactionHook - Rapid-Fire Debounce (issue #453)', () => {
+    const SESSION_ID = 'debounce-test-session';
+    beforeEach(() => {
+        resetSessionTokenEstimate(SESSION_ID);
+        clearRapidFireDebounce(SESSION_ID);
+    });
+    afterEach(() => {
+        resetSessionTokenEstimate(SESSION_ID);
+        clearRapidFireDebounce(SESSION_ID);
+    });
+    it('should process the first postToolUse call normally', () => {
+        const hook = createPreemptiveCompactionHook({
+            warningThreshold: 0.01, // Very low threshold to trigger easily
+            criticalThreshold: 0.02,
+        });
+        const result = hook.postToolUse({
+            tool_name: 'Task',
+            session_id: SESSION_ID,
+            tool_input: {},
+            tool_response: 'x'.repeat(1_000_000), // Large response
+        });
+        // First call should produce a warning (threshold is very low)
+        // Result can be string (warning) or null (if tokens not enough)
+        // The important thing is it runs analysis, not that it warns
+        expect(result === null || typeof result === 'string').toBe(true);
+    });
+    it('should debounce rapid-fire calls within the debounce window', () => {
+        const hook = createPreemptiveCompactionHook({
+            warningThreshold: 0.01,
+            criticalThreshold: 0.02,
+        });
+        const makeInput = () => ({
+            tool_name: 'Task',
+            session_id: SESSION_ID,
+            tool_input: {},
+            tool_response: 'x'.repeat(100_000),
+        });
+        // First call runs analysis
+        hook.postToolUse(makeInput());
+        // Rapid-fire calls within debounce window should be skipped
+        const result2 = hook.postToolUse(makeInput());
+        const result3 = hook.postToolUse(makeInput());
+        const result4 = hook.postToolUse(makeInput());
+        const result5 = hook.postToolUse(makeInput());
+        // All debounced calls should return null (skipped)
+        expect(result2).toBeNull();
+        expect(result3).toBeNull();
+        expect(result4).toBeNull();
+        expect(result5).toBeNull();
+    });
+    it('should still accumulate tokens even when debounced', () => {
+        const hook = createPreemptiveCompactionHook();
+        const makeInput = (response) => ({
+            tool_name: 'Task',
+            session_id: SESSION_ID,
+            tool_input: {},
+            tool_response: response,
+        });
+        // First call
+        hook.postToolUse(makeInput('x'.repeat(1000)));
+        // Debounced calls - tokens should still accumulate
+        hook.postToolUse(makeInput('y'.repeat(2000)));
+        hook.postToolUse(makeInput('z'.repeat(3000)));
+        // Verify tokens accumulated
+        const tokens = getSessionTokenEstimate(SESSION_ID);
+        // Should have accumulated tokens from all 3 calls (not just the first)
+        // Each char is ~0.25 tokens (CHARS_PER_TOKEN = 4)
+        expect(tokens).toBeGreaterThan(0);
+        // 6000 chars / 4 = 1500 tokens minimum
+        expect(tokens).toBeGreaterThanOrEqual(1500);
+    });
+    it('should process calls again after debounce window expires', async () => {
+        vi.useFakeTimers();
+        try {
+            const hook = createPreemptiveCompactionHook({
+                warningThreshold: 0.01,
+                criticalThreshold: 0.02,
+            });
+            const makeInput = () => ({
+                tool_name: 'Task',
+                session_id: SESSION_ID,
+                tool_input: {},
+                tool_response: 'x'.repeat(100_000),
+            });
+            // First call runs analysis
+            hook.postToolUse(makeInput());
+            // Advance past debounce window
+            vi.advanceTimersByTime(RAPID_FIRE_DEBOUNCE_MS + 10);
+            // Next call should run analysis again (not be debounced)
+            const result = hook.postToolUse(makeInput());
+            expect(result === null || typeof result === 'string').toBe(true);
+        }
+        finally {
+            vi.useRealTimers();
+        }
+    });
+    it('should not debounce calls for different sessions', () => {
+        const hook = createPreemptiveCompactionHook({
+            warningThreshold: 0.01,
+            criticalThreshold: 0.02,
+        });
+        const SESSION_2 = 'debounce-test-session-2';
+        try {
+            // Call for session 1
+            hook.postToolUse({
+                tool_name: 'Task',
+                session_id: SESSION_ID,
+                tool_input: {},
+                tool_response: 'x'.repeat(100_000),
+            });
+            // Call for session 2 should NOT be debounced
+            const result = hook.postToolUse({
+                tool_name: 'Task',
+                session_id: SESSION_2,
+                tool_input: {},
+                tool_response: 'x'.repeat(100_000),
+            });
+            // Should run analysis (not debounced), may or may not produce warning
+            expect(result === null || typeof result === 'string').toBe(true);
+        }
+        finally {
+            resetSessionTokenEstimate(SESSION_2);
+            clearRapidFireDebounce(SESSION_2);
+        }
+    });
+    it('should clear debounce state on stop', () => {
+        const hook = createPreemptiveCompactionHook();
+        // Trigger a call to set debounce state
+        hook.postToolUse({
+            tool_name: 'Bash',
+            session_id: SESSION_ID,
+            tool_input: {},
+            tool_response: 'some output',
+        });
+        // Stop should clear debounce
+        hook.stop({ session_id: SESSION_ID });
+        // Next call after stop should not be debounced (runs analysis)
+        // We verify indirectly: no crash, runs without error
+        const result = hook.postToolUse({
+            tool_name: 'Bash',
+            session_id: SESSION_ID,
+            tool_input: {},
+            tool_response: 'some output',
+        });
+        expect(result === null || typeof result === 'string').toBe(true);
+    });
+    it('RAPID_FIRE_DEBOUNCE_MS should be a reasonable value', () => {
+        // Debounce should be short enough to not delay normal operations
+        // but long enough to catch simultaneous subagent completions
+        expect(RAPID_FIRE_DEBOUNCE_MS).toBeGreaterThanOrEqual(100);
+        expect(RAPID_FIRE_DEBOUNCE_MS).toBeLessThanOrEqual(2000);
+    });
+});
+//# sourceMappingURL=compaction-concurrency.test.js.map

package/dist/hooks/__tests__/compaction-concurrency.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-concurrency.test.js","sourceRoot":"","sources":["../../../src/hooks/__tests__/compaction-concurrency.test.ts"],"names":[],"mappings":"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"}

package/dist/hooks/agent-usage-reminder/constants.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Agent Usage Reminder Constants
+ *
+ * Constants for tracking tool usage and encouraging agent delegation.
+ *
+ * Ported from oh-my-opencode's agent-usage-reminder hook.
+ */
+/** Storage directory for agent usage reminder state */
+export declare const OMC_STORAGE_DIR: string;
+export declare const AGENT_USAGE_REMINDER_STORAGE: string;
+/** All tool names normalized to lowercase for case-insensitive matching */
+export declare const TARGET_TOOLS: Set<string>;
+/** Agent tools that indicate agent usage */
+export declare const AGENT_TOOLS: Set<string>;
+/** Reminder message shown to users */
+export declare const REMINDER_MESSAGE = "\n[Agent Usage Reminder]\n\nYou called a search/fetch tool directly without leveraging specialized agents.\n\nRECOMMENDED: Use Task tool with explore/document-specialist agents for better results:\n\n```\n// Parallel exploration - fire multiple agents simultaneously\nTask(agent=\"explore\", prompt=\"Find all files matching pattern X\")\nTask(agent=\"explore\", prompt=\"Search for implementation of Y\")\nTask(agent=\"document-specialist\", prompt=\"Lookup documentation for Z\")\n\n// Then continue your work while they run in background\n// System will notify you when each completes\n```\n\nWHY:\n- Agents can perform deeper, more thorough searches\n- Background tasks run in parallel, saving time\n- Specialized agents have domain expertise\n- Reduces context window usage in main session\n\nALWAYS prefer: Multiple parallel Task calls > Direct tool calls\n";
+//# sourceMappingURL=constants.d.ts.map

package/dist/hooks/agent-usage-reminder/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/hooks/agent-usage-reminder/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,uDAAuD;AACvD,eAAO,MAAM,eAAe,QAA0B,CAAC;AACvD,eAAO,MAAM,4BAA4B,QAGxC,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,YAAY,aAUvB,CAAC;AAEH,4CAA4C;AAC5C,eAAO,MAAM,WAAW,aAItB,CAAC;AAEH,sCAAsC;AACtC,eAAO,MAAM,gBAAgB,o2BAwB5B,CAAC"}

package/dist/hooks/agent-usage-reminder/constants.js

@@ -0,0 +1,57 @@
+/**
+ * Agent Usage Reminder Constants
+ *
+ * Constants for tracking tool usage and encouraging agent delegation.
+ *
+ * Ported from oh-my-opencode's agent-usage-reminder hook.
+ */
+import { join } from 'path';
+import { homedir } from 'os';
+/** Storage directory for agent usage reminder state */
+export const OMC_STORAGE_DIR = join(homedir(), '.omc');
+export const AGENT_USAGE_REMINDER_STORAGE = join(OMC_STORAGE_DIR, 'agent-usage-reminder');
+/** All tool names normalized to lowercase for case-insensitive matching */
+export const TARGET_TOOLS = new Set([
+    'grep',
+    'safe_grep',
+    'glob',
+    'safe_glob',
+    'webfetch',
+    'context7_resolve-library-id',
+    'context7_query-docs',
+    'websearch_web_search_exa',
+    'context7_get-library-docs',
+]);
+/** Agent tools that indicate agent usage */
+export const AGENT_TOOLS = new Set([
+    'task',
+    'call_omo_agent',
+    'omc_task',
+]);
+/** Reminder message shown to users */
+export const REMINDER_MESSAGE = `
+[Agent Usage Reminder]
+
+You called a search/fetch tool directly without leveraging specialized agents.
+
+RECOMMENDED: Use Task tool with explore/document-specialist agents for better results:
+
+\`\`\`
+// Parallel exploration - fire multiple agents simultaneously
+Task(agent="explore", prompt="Find all files matching pattern X")
+Task(agent="explore", prompt="Search for implementation of Y")
+Task(agent="document-specialist", prompt="Lookup documentation for Z")
+
+// Then continue your work while they run in background
+// System will notify you when each completes
+\`\`\`
+
+WHY:
+- Agents can perform deeper, more thorough searches
+- Background tasks run in parallel, saving time
+- Specialized agents have domain expertise
+- Reduces context window usage in main session
+
+ALWAYS prefer: Multiple parallel Task calls > Direct tool calls
+`;
+//# sourceMappingURL=constants.js.map

package/dist/hooks/agent-usage-reminder/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/hooks/agent-usage-reminder/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAE7B,uDAAuD;AACvD,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;AACvD,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAC9C,eAAe,EACf,sBAAsB,CACvB,CAAC;AAEF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAClC,MAAM;IACN,WAAW;IACX,MAAM;IACN,WAAW;IACX,UAAU;IACV,6BAA6B;IAC7B,qBAAqB;IACrB,0BAA0B;IAC1B,2BAA2B;CAC5B,CAAC,CAAC;AAEH,4CAA4C;AAC5C,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IACjC,MAAM;IACN,gBAAgB;IAChB,UAAU;CACX,CAAC,CAAC;AAEH,sCAAsC;AACtC,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwB/B,CAAC"}

package/dist/hooks/agent-usage-reminder/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Agent Usage Reminder Hook
+ *
+ * Reminds users to use specialized agents when they make direct tool calls
+ * for searching or fetching content instead of delegating to agents.
+ *
+ * This hook tracks tool usage and appends reminder messages to tool outputs
+ * when users haven't been using agents effectively.
+ *
+ * Ported from oh-my-opencode's agent-usage-reminder hook.
+ * Adapted for Claude Code's shell-based hook system.
+ */
+export { loadAgentUsageState, saveAgentUsageState, clearAgentUsageState } from './storage.js';
+export { TARGET_TOOLS, AGENT_TOOLS, REMINDER_MESSAGE } from './constants.js';
+export type { AgentUsageState } from './types.js';
+interface ToolExecuteInput {
+    tool: string;
+    sessionID: string;
+    callID: string;
+}
+interface ToolExecuteOutput {
+    title: string;
+    output: string;
+    metadata: unknown;
+}
+interface EventInput {
+    event: {
+        type: string;
+        properties?: unknown;
+    };
+}
+export declare function createAgentUsageReminderHook(): {
+    'tool.execute.after': (input: ToolExecuteInput, output: ToolExecuteOutput) => Promise<void>;
+    event: ({ event }: EventInput) => Promise<void>;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/agent-usage-reminder/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/agent-usage-reminder/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAWH,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC9F,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,iBAAiB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,UAAU;IAClB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;CACH;AAED,wBAAgB,4BAA4B;kCA8BjC,gBAAgB,UACf,iBAAiB;uBA8BY,UAAU;EAyBlD"}

package/dist/hooks/agent-usage-reminder/index.js

@@ -0,0 +1,89 @@
+/**
+ * Agent Usage Reminder Hook
+ *
+ * Reminds users to use specialized agents when they make direct tool calls
+ * for searching or fetching content instead of delegating to agents.
+ *
+ * This hook tracks tool usage and appends reminder messages to tool outputs
+ * when users haven't been using agents effectively.
+ *
+ * Ported from oh-my-opencode's agent-usage-reminder hook.
+ * Adapted for Claude Code's shell-based hook system.
+ */
+import { loadAgentUsageState, saveAgentUsageState, clearAgentUsageState, } from './storage.js';
+import { TARGET_TOOLS, AGENT_TOOLS, REMINDER_MESSAGE } from './constants.js';
+// Re-export types and utilities
+export { loadAgentUsageState, saveAgentUsageState, clearAgentUsageState } from './storage.js';
+export { TARGET_TOOLS, AGENT_TOOLS, REMINDER_MESSAGE } from './constants.js';
+export function createAgentUsageReminderHook() {
+    const sessionStates = new Map();
+    function getOrCreateState(sessionID) {
+        if (!sessionStates.has(sessionID)) {
+            const persisted = loadAgentUsageState(sessionID);
+            const state = persisted ?? {
+                sessionID,
+                agentUsed: false,
+                reminderCount: 0,
+                updatedAt: Date.now(),
+            };
+            sessionStates.set(sessionID, state);
+        }
+        return sessionStates.get(sessionID);
+    }
+    function markAgentUsed(sessionID) {
+        const state = getOrCreateState(sessionID);
+        state.agentUsed = true;
+        state.updatedAt = Date.now();
+        saveAgentUsageState(state);
+    }
+    function resetState(sessionID) {
+        sessionStates.delete(sessionID);
+        clearAgentUsageState(sessionID);
+    }
+    const toolExecuteAfter = async (input, output) => {
+        const { tool, sessionID } = input;
+        const toolLower = tool.toLowerCase();
+        // Mark agent as used if agent tool was called
+        if (AGENT_TOOLS.has(toolLower)) {
+            markAgentUsed(sessionID);
+            return;
+        }
+        // Only track target tools (search/fetch tools)
+        if (!TARGET_TOOLS.has(toolLower)) {
+            return;
+        }
+        const state = getOrCreateState(sessionID);
+        // Don't remind if agent has been used
+        if (state.agentUsed) {
+            return;
+        }
+        // Append reminder message to output
+        output.output += REMINDER_MESSAGE;
+        state.reminderCount++;
+        state.updatedAt = Date.now();
+        saveAgentUsageState(state);
+    };
+    const eventHandler = async ({ event }) => {
+        const props = event.properties;
+        // Clean up state when session is deleted
+        if (event.type === 'session.deleted') {
+            const sessionInfo = props?.info;
+            if (sessionInfo?.id) {
+                resetState(sessionInfo.id);
+            }
+        }
+        // Clean up state when session is compacted
+        if (event.type === 'session.compacted') {
+            const sessionID = (props?.sessionID ??
+                props?.info?.id);
+            if (sessionID) {
+                resetState(sessionID);
+            }
+        }
+    };
+    return {
+        'tool.execute.after': toolExecuteAfter,
+        event: eventHandler,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/hooks/agent-usage-reminder/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/agent-usage-reminder/index.ts"],"names":[],"mappings":"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"}

package/dist/hooks/agent-usage-reminder/storage.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Agent Usage Reminder Storage
+ *
+ * Persists agent usage state across sessions.
+ *
+ * Ported from oh-my-opencode's agent-usage-reminder hook.
+ */
+import type { AgentUsageState } from './types.js';
+export declare function loadAgentUsageState(sessionID: string): AgentUsageState | null;
+export declare function saveAgentUsageState(state: AgentUsageState): void;
+export declare function clearAgentUsageState(sessionID: string): void;
+//# sourceMappingURL=storage.d.ts.map

package/dist/hooks/agent-usage-reminder/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/hooks/agent-usage-reminder/storage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAMlD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAU7E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAOhE;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAK5D"}

package/dist/hooks/agent-usage-reminder/storage.js

@@ -0,0 +1,39 @@
+/**
+ * Agent Usage Reminder Storage
+ *
+ * Persists agent usage state across sessions.
+ *
+ * Ported from oh-my-opencode's agent-usage-reminder hook.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, unlinkSync, } from 'fs';
+import { join } from 'path';
+import { AGENT_USAGE_REMINDER_STORAGE } from './constants.js';
+function getStoragePath(sessionID) {
+    return join(AGENT_USAGE_REMINDER_STORAGE, `${sessionID}.json`);
+}
+export function loadAgentUsageState(sessionID) {
+    const filePath = getStoragePath(sessionID);
+    if (!existsSync(filePath))
+        return null;
+    try {
+        const content = readFileSync(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+export function saveAgentUsageState(state) {
+    if (!existsSync(AGENT_USAGE_REMINDER_STORAGE)) {
+        mkdirSync(AGENT_USAGE_REMINDER_STORAGE, { recursive: true });
+    }
+    const filePath = getStoragePath(state.sessionID);
+    writeFileSync(filePath, JSON.stringify(state, null, 2));
+}
+export function clearAgentUsageState(sessionID) {
+    const filePath = getStoragePath(sessionID);
+    if (existsSync(filePath)) {
+        unlinkSync(filePath);
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/hooks/agent-usage-reminder/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/hooks/agent-usage-reminder/storage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,UAAU,EACV,SAAS,EACT,YAAY,EACZ,aAAa,EACb,UAAU,GACX,MAAM,IAAI,CAAC;AACZ,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAG9D,SAAS,cAAc,CAAC,SAAiB;IACvC,OAAO,IAAI,CAAC,4BAA4B,EAAE,GAAG,SAAS,OAAO,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAC3C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAoB,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAsB;IACxD,IAAI,CAAC,UAAU,CAAC,4BAA4B,CAAC,EAAE,CAAC;QAC9C,SAAS,CAAC,4BAA4B,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACjD,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAC3C,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,UAAU,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/hooks/agent-usage-reminder/types.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Agent Usage Reminder Types
+ *
+ * Tracks agent usage to encourage delegation to specialized agents.
+ *
+ * Ported from oh-my-opencode's agent-usage-reminder hook.
+ */
+export interface AgentUsageState {
+    sessionID: string;
+    agentUsed: boolean;
+    reminderCount: number;
+    updatedAt: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/hooks/agent-usage-reminder/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/hooks/agent-usage-reminder/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/hooks/agent-usage-reminder/types.js

@@ -0,0 +1,9 @@
+/**
+ * Agent Usage Reminder Types
+ *
+ * Tracks agent usage to encourage delegation to specialized agents.
+ *
+ * Ported from oh-my-opencode's agent-usage-reminder hook.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/hooks/agent-usage-reminder/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/hooks/agent-usage-reminder/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}