opencode-matrixx-v2 1.2.0 → 1.2.1

package/dist/hooks/category-skill-reminder/detector.d.ts

@@ -0,0 +1,13 @@
+export interface NudgeInput {
+    tool: string;
+    sessionID: string;
+    agent?: string;
+    toolCallCount: number;
+    delegationUsed: boolean;
+    reminderShown: boolean;
+}
+export interface NudgeEvent {
+    skill: string;
+    reason: string;
+}
+export declare function detectNudge(input: NudgeInput): NudgeEvent | null;

package/dist/hooks/category-skill-reminder/formatter.d.ts

@@ -1,2 +1,7 @@
 import type { AvailableSkill } from "../../agents/dynamic-agent-prompt-builder";
 export declare function buildReminderMessage(availableSkills: AvailableSkill[]): string;
+export interface NudgeMessageEvent {
+    skill: string;
+    reason: string;
+}
+export declare function buildNudgeMessage(event: NudgeMessageEvent): string;

package/dist/hooks/category-skill-reminder/hook.d.ts

@@ -1,5 +1,7 @@
 import type { AvailableSkill } from "../../agents/dynamic-agent-prompt-builder";
 import type { MatrixxContext } from "../../plugin/context";
+export type { NudgeEvent, NudgeInput } from "./detector";
+export { detectNudge } from "./detector";
 interface ToolExecuteInput {
     tool: string;
     sessionID: string;
@@ -11,9 +13,11 @@ interface ToolExecuteOutput {
     output: string;
     metadata: unknown;
 }
+export interface CategorySkillReminderOptions {
+    now?: () => number;
+}
 import type { V2Event } from "../../plugin/context";
-export declare function createCategorySkillReminderHook(ctx: MatrixxContext, availableSkills?: AvailableSkill[]): {
+export declare function createCategorySkillReminderHook(ctx: MatrixxContext, availableSkills?: AvailableSkill[], options?: CategorySkillReminderOptions): {
     "tool.execute.after": (input: ToolExecuteInput, output: ToolExecuteOutput) => Promise<void>;
     event: (event: V2Event) => Promise<void>;
 };
-export {};

package/dist/index.js

@@ -26192,7 +26192,7 @@ function buildInlineConfig(profile, options) {
   const commands = merged.commands ?? {};
   const manualMode = merged.manualMode ?? {};
   return {
-    $schema: "https://raw.githubusercontent.com/Opencode-DCP/opencode-dynamic-context-pruning/v3.1.14/dcp.schema.json",
+    $schema: "https://raw.githubusercontent.com/Opencode-DCP/opencode-dynamic-context-pruning/v3.2.0/dcp.schema.json",
     enabled: true,
     autoUpdate: merged.autoUpdate ?? false,
     debug: merged.debug ?? false,
@@ -76209,6 +76209,51 @@ function createBashFileReadGuardHook() {
     }
   };
 }
+// src/hooks/category-skill-reminder/detector.ts
+var TARGET_AGENTS = new Set([
+  "morpheus",
+  "mouse",
+  "niobe"
+]);
+var DELEGATABLE_WORK_TOOLS = new Set([
+  "edit",
+  "write",
+  "bash",
+  "shell",
+  "read",
+  "grep",
+  "glob"
+]);
+var NUDGE_THRESHOLD = 3;
+var NUDGE_SKILL = "construct";
+function isTargetAgent(sessionID, inputAgent) {
+  const agent = getSessionAgent(sessionID) ?? inputAgent;
+  if (!agent)
+    return false;
+  const agentKey = getAgentConfigKey(agent);
+  return TARGET_AGENTS.has(agentKey) || agentKey.includes("morpheus") || agentKey.includes("niobe");
+}
+function detectNudge(input) {
+  try {
+    if (subagentSessions.has(input.sessionID))
+      return null;
+    if (!isTargetAgent(input.sessionID, input.agent))
+      return null;
+    if (!DELEGATABLE_WORK_TOOLS.has(input.tool.toLowerCase()))
+      return null;
+    if (input.delegationUsed || input.reminderShown)
+      return null;
+    if (input.toolCallCount < NUDGE_THRESHOLD)
+      return null;
+    return {
+      skill: NUDGE_SKILL,
+      reason: `delegatable work without delegation (${input.toolCallCount} ${input.tool} calls)`
+    };
+  } catch {
+    return null;
+  }
+}
+
 // src/hooks/category-skill-reminder/formatter.ts
 function formatSkillNames(skills, limit) {
   if (skills.length === 0)
@@ -76244,12 +76289,12 @@ function buildReminderMessage(availableSkills) {
 }
 
 // src/hooks/category-skill-reminder/hook.ts
-var TARGET_AGENTS = new Set([
+var TARGET_AGENTS2 = new Set([
   "morpheus",
   "mouse",
   "niobe"
 ]);
-var DELEGATABLE_WORK_TOOLS = new Set([
+var DELEGATABLE_WORK_TOOLS2 = new Set([
   "edit",
   "write",
   "bash",
@@ -76262,6 +76307,7 @@ var DELEGATION_TOOLS = new Set([
   "task",
   "subagent"
 ]);
+var DEDUP_WINDOW_MS2 = 60000;
 function hashSnippet(value) {
   let hash = 5381;
   for (let i = 0;i < value.length; i++) {
@@ -76269,9 +76315,11 @@ function hashSnippet(value) {
   }
   return (hash >>> 0).toString(16);
 }
-function createCategorySkillReminderHook(ctx, availableSkills = []) {
+function createCategorySkillReminderHook(ctx, availableSkills = [], options = {}) {
   const sessionStates = new Map;
+  const lastNudgeAt = new Map;
   const reminderMessage = buildReminderMessage(availableSkills);
+  const now = options.now ?? Date.now;
   function getOrCreateState(sessionID) {
     if (!sessionStates.has(sessionID)) {
       sessionStates.set(sessionID, {
@@ -76282,58 +76330,103 @@ function createCategorySkillReminderHook(ctx, availableSkills = []) {
     }
     return sessionStates.get(sessionID);
   }
+  function clearSessionState(sessionID) {
+    sessionStates.delete(sessionID);
+  }
+  function clearSessionDedup(sessionID) {
+    const prefix = `${sessionID}:`;
+    for (const key of lastNudgeAt.keys()) {
+      if (key.startsWith(prefix))
+        lastNudgeAt.delete(key);
+    }
+  }
   function isTargetAgent(sessionID, inputAgent) {
     const agent = getSessionAgent(sessionID) ?? inputAgent;
     if (!agent)
       return false;
     const agentKey = getAgentConfigKey(agent);
-    return TARGET_AGENTS.has(agentKey) || agentKey.includes("morpheus") || agentKey.includes("niobe");
+    return TARGET_AGENTS2.has(agentKey) || agentKey.includes("morpheus") || agentKey.includes("niobe");
   }
   const toolExecuteAfter = async (input, output) => {
-    const { tool, sessionID } = input;
-    const toolLower = tool.toLowerCase();
-    if (!isTargetAgent(sessionID, input.agent)) {
-      return;
-    }
-    const state = getOrCreateState(sessionID);
-    if (DELEGATION_TOOLS.has(toolLower)) {
-      state.delegationUsed = true;
-      log("[category-skill-reminder] Delegation tool used", { sessionID, tool });
-      return;
-    }
-    if (!DELEGATABLE_WORK_TOOLS.has(toolLower)) {
+    try {
+      const { tool, sessionID } = input;
+      const toolLower = tool.toLowerCase();
+      if (subagentSessions.has(sessionID))
+        return;
+      if (!isTargetAgent(sessionID, input.agent)) {
+        return;
+      }
+      const state = getOrCreateState(sessionID);
+      if (DELEGATION_TOOLS.has(toolLower)) {
+        state.delegationUsed = true;
+        log("[category-skill-reminder] Delegation tool used", { sessionID, tool });
+        return;
+      }
+      if (!DELEGATABLE_WORK_TOOLS2.has(toolLower)) {
+        return;
+      }
+      state.toolCallCount++;
+      let nudge = null;
+      try {
+        nudge = detectNudge({
+          tool,
+          sessionID,
+          agent: input.agent,
+          toolCallCount: state.toolCallCount,
+          delegationUsed: state.delegationUsed,
+          reminderShown: state.reminderShown
+        });
+      } catch {
+        nudge = null;
+      }
+      if (nudge) {
+        const dedupKey = `${sessionID}:${toolLower}:${nudge.skill}`;
+        const lastAt = lastNudgeAt.get(dedupKey);
+        const current = now();
+        if (lastAt !== undefined && current - lastAt < DEDUP_WINDOW_MS2) {
+          return;
+        }
+        lastNudgeAt.set(dedupKey, current);
+        output.output += reminderMessage;
+        state.reminderShown = true;
+        log("[category-skill-reminder] Reminder injected", {
+          sessionID,
+          toolCallCount: state.toolCallCount
+        });
+        try {
+          await notifyInjection(ctx, {
+            sessionID,
+            injector: "category-skill-reminder",
+            hash: hashSnippet(reminderMessage),
+            title: "Context injection",
+            message: "Delegation guidance applied"
+          });
+        } catch {
+          return;
+        }
+      }
+    } catch {
       return;
     }
-    state.toolCallCount++;
-    if (state.toolCallCount >= 3 && !state.delegationUsed && !state.reminderShown) {
-      output.output += reminderMessage;
-      state.reminderShown = true;
-      log("[category-skill-reminder] Reminder injected", {
-        sessionID,
-        toolCallCount: state.toolCallCount
-      });
-      await notifyInjection(ctx, {
-        sessionID,
-        injector: "category-skill-reminder",
-        hash: hashSnippet(reminderMessage),
-        title: "Context injection",
-        message: "Delegation guidance applied"
-      });
-    }
   };
   const eventHandler = async (event) => {
-    const props = event.data;
-    if (event.type === "session.deleted") {
-      const sessionInfo = props?.info;
-      if (sessionInfo?.id) {
-        sessionStates.delete(sessionInfo.id);
+    try {
+      const props = event.data;
+      if (event.type === "session.deleted") {
+        const sessionInfo = props?.info;
+        if (sessionInfo?.id) {
+          clearSessionState(sessionInfo.id);
+          clearSessionDedup(sessionInfo.id);
+        }
       }
-    }
-    if (event.type === "session.compacted") {
-      const sessionID = props?.sessionID ?? props?.info?.id;
-      if (sessionID) {
-        sessionStates.delete(sessionID);
+      if (event.type === "session.compacted") {
+        const sessionID = props?.sessionID ?? props?.info?.id;
+        if (sessionID) {
+          clearSessionState(sessionID);
+        }
       }
+    } catch {
+      return;
     }
   };
   return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-matrixx-v2",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "The Best AI Agent Harness - Batteries-Included OpenCode Plugin with Multi-Model Orchestration, Parallel Background Agents, and Crafted LSP/AST Tools",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",