oc-tweaks 0.6.0 → 0.7.1

package/README.md

@@ -136,7 +136,7 @@ This plugin provides an intelligent memory workflow:
 
 ### `backgroundSubagent`
 
-This plugin injects a policy into the system prompt, reminding the AI agent to use `run_in_background=true` by default when dispatching sub-agents. It helps maintain a responsive main conversation. If a foreground task is dispatched, a friendly reminder is shown.
+This plugin injects a policy into the system prompt, reminding the AI agent to use `run_in_background=true` by default when dispatching sub-agents. It also requires each `task()` description to expose a compact transparency summary: agent type, loaded skills, background/foreground mode, and resume session when present. If a foreground task is dispatched, or if required transparency tags are missing, a friendly reminder is shown.
 
 **Configuration Options:**
 
@@ -357,7 +357,7 @@ bunx oc-tweaks init
 
 ### `backgroundSubagent`
 
-此插件向系统提示中注入一项策略，提醒 AI 代理在派发子代理时默认使用 `run_in_background=true`。这有助于保持主对话的响应性。如果派发了前台任务，则会显示一个友好的提醒。
+此插件向系统提示中注入一项策略，提醒 AI 代理在派发子代理时默认使用 `run_in_background=true`。它也要求每次 `task()` 调用在 `description` 里写出紧凑的透明度摘要：agent 类型、已加载 skills、background/foreground 模式，以及存在时的 resume session。若派发了前台任务，或缺少必需透明度标签，插件都会追加友好提醒。
 
 **配置选项:**
 

package/dist/index.js

@@ -289,12 +289,68 @@ 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 a compact transparency summary in the \`description\` field so the user can see how the sub-agent was dispatched.
+
+Required formats:
+- \`[category:xxx]\` when using \`category\`
+- \`[subagent:xxx]\` when using \`subagent_type\`
+- \`[skills:skill-a,skill-b]\` or \`[skills:none]\`
+- \`[background]\` or \`[foreground]\`
+- \`[resume:session-id]\` when using \`session_id\`
+
+Examples:
+- \`description="[category:quick] [skills:none] [background] Fix typo in config"\`
+- \`description="[subagent:explore] [skills:none] [background] Inspect auth flow"\`
+- \`description="[category:deep] [skills:refactor,test-driven-development] [foreground] [resume:ses_123] Continue auth refactor"\`
+
+Do NOT omit any required transparency 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);
+  }
+  const skillsTag = args?.load_skills && args.load_skills.length > 0 ? `[skills:${args.load_skills.join(",")}]` : `[skills:none]`;
+  if (!description.includes(skillsTag))
+    missingTags.push(skillsTag);
+  const modeTag = args?.run_in_background === false ? `[foreground]` : `[background]`;
+  if (!description.includes(modeTag))
+    missingTags.push(modeTag);
+  if (args?.session_id) {
+    const tag = `[resume:${args.session_id}]`;
+    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 the dispatch mode, loaded skills, and resume status.
+Required formats:
+- \`[category:xxx]\`
+- \`[subagent:xxx]\`
+- \`[skills:skill-a,skill-b]\` or \`[skills:none]\`
+- \`[background]\` or \`[foreground]\`
+- \`[resume:session-id]\` when applicable`;
+}
 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 +364,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.1",
   "type": "module",
   "exports": {
     ".": "./dist/index.js"