oc-tweaks 0.6.0 → 0.7.0

package/dist/index.js

@@ -289,12 +289,50 @@ Only use \`run_in_background=false\` when ALL of these conditions are met:
 3. The user is explicitly waiting for that specific result
 
 When in doubt → background. Use \`background_output()\` to collect results later.
+
+## Description Transparency Rule
+
+Every \`task()\` call MUST include an agent label in the \`description\` field so the user can see which mode you used.
+
+Required formats:
+- \`[category:xxx]\` when using \`category\`
+- \`[subagent:xxx]\` when using \`subagent_type\`
+
+Examples:
+- \`description="[category:quick] Fix typo in config"\`
+- \`description="[subagent:explore] Inspect auth flow"\`
+
+Do NOT omit the tag.
 `;
 var VIOLATION_WARNING = `\uD83D\uDCA1 [Reminder] Consider using background mode for better responsiveness.
 You used foreground mode (run_in_background=false). Check the three conditions in the system prompt.
 If not all three are met, consider run_in_background=true + background_output() for next time.`;
+function getMissingTransparencyTags(args) {
+  const description = args?.description ?? "";
+  const missingTags = [];
+  if (args?.category) {
+    const tag = `[category:${args.category}]`;
+    if (!description.includes(tag))
+      missingTags.push(tag);
+  }
+  if (args?.subagent_type) {
+    const tag = `[subagent:${args.subagent_type}]`;
+    if (!description.includes(tag))
+      missingTags.push(tag);
+  }
+  return missingTags;
+}
+function buildTransparencyWarning(missingTags) {
+  const plural = missingTags.length > 1 ? "s" : "";
+  return `⚠️ [Transparency] Your task description is missing the required transparency tag${plural}: ${missingTags.join(", ")}
+Add the tag directly to \`description\` so the user can see which agent mode you used.
+Required formats:
+- \`[category:xxx]\`
+- \`[subagent:xxx]\``;
+}
 var backgroundSubagentPlugin = async () => {
   const foregroundCalls = new Set;
+  const transparencyViolations = new Map;
   return {
     "experimental.chat.system.transform": safeHook("background-subagent:system.transform", async (_input, output) => {
       const config = await loadOcTweaksConfig();
@@ -308,17 +346,32 @@ var backgroundSubagentPlugin = async () => {
         return;
       if (input.tool !== "task")
         return;
+      const missingTags = getMissingTransparencyTags(output.args);
+      if (missingTags.length > 0) {
+        transparencyViolations.set(input.callID, missingTags);
+      }
       if (!output.args?.run_in_background) {
         foregroundCalls.add(input.callID);
       }
     }),
     "tool.execute.after": safeHook("background-subagent:tool.execute.after", async (input, output) => {
-      if (!foregroundCalls.has(input.callID))
+      const warnings = [];
+      if (foregroundCalls.has(input.callID)) {
+        foregroundCalls.delete(input.callID);
+        warnings.push(VIOLATION_WARNING);
+      }
+      const missingTags = transparencyViolations.get(input.callID);
+      if (missingTags) {
+        transparencyViolations.delete(input.callID);
+        warnings.push(buildTransparencyWarning(missingTags));
+      }
+      if (warnings.length === 0)
         return;
-      foregroundCalls.delete(input.callID);
       output.output += `
 
-${VIOLATION_WARNING}`;
+${warnings.join(`
+
+`)}`;
     })
   };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oc-tweaks",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "type": "module",
   "exports": {
     ".": "./dist/index.js"