@duckmind/dm-windows-x64 0.60.4 → 0.60.8

package/extensions/dm-subagents/src/intercom/native-supervisor-channel.js

@@ -1,5 +1,452 @@
-import{randomUUID as Qj}from"node:crypto";import*as W from"node:fs";import*as U from"node:path";import{Type as Y}from"typebox";import*as K from"node:path";import{fileURLToPath as c}from"node:url";import*as V from"node:os";import*as T from"node:path";import*as L from"node:os";import*as C from"node:path";function z(j){return j.trim().replace(/[^A-Za-z0-9._-]+/g,"-").replace(/^-+|-+$/g,"")||"unknown"}function l(j){let $=j?.env??process.env,f=j&&Object.hasOwn(j,"getuid")?j.getuid:process.getuid?.bind(process);if(typeof f==="function")return`uid-${f()}`;for(let Q of["USERNAME","USER","LOGNAME"]){let O=$[Q];if(O)return`user-${z(O)}`}let J=j&&Object.hasOwn(j,"userInfo")?j.userInfo:L.userInfo;try{let Q=J?.().username;if(Q)return`user-${z(Q)}`}catch{}let B=$.USERPROFILE??$.HOME;if(B)return`home-${z(B)}`;let Z=j&&Object.hasOwn(j,"homedir")?j.homedir:L.homedir;try{let Q=Z?.();if(Q)return`home-${z(Q)}`}catch{}return"shared"}var A=C.join(L.tmpdir(),`dm-subagents-${l()}`),cj=C.join(A,"async-subagent-results"),qj=C.join(A,"async-subagent-runs"),s=C.join(A,"chain-runs"),Ij=C.join(A,"artifacts");var w=250;var f$=T.join(V.homedir(),".config","mcp","mcp.json"),J$={cursor:[T.join(V.homedir(),".cursor","mcp.json")],"claude-code":[T.join(V.homedir(),".claude","mcp.json"),T.join(V.homedir(),".claude.json"),T.join(V.homedir(),".claude","claude_desktop_config.json")],"claude-desktop":[T.join(V.homedir(),"Library","Application Support","Claude","claude_desktop_config.json")],codex:[T.join(V.homedir(),".codex","config.json")],windsurf:[T.join(V.homedir(),".windsurf","mcp.json")],vscode:[".vscode/mcp.json"]};import{Compile as Q$}from"typebox/compile";function q(j,$){let f=c(j),J=K.extname(f),B=[".js",".mjs",".cjs",".ts",".mts",".cts"].includes(J)?J:".ts";return K.join(K.dirname(f),`${$}${B}`)}function I(j){return K.basename(c(j)).startsWith("dm-args.")}function i(j=import.meta.url){let $=I(j)?"subagent-prompt-runtime":K.join("..","runs","shared","subagent-prompt-runtime");return q(j,$)}function a(j=import.meta.url){let $=I(j)?K.join("..","..","extension","fanout-child"):"fanout-child";return q(j,$)}var z$=i(),b$=a();var x="DM_SUBAGENT_ORCHESTRATOR_TARGET",D="DM_SUBAGENT_ORCHESTRATOR_SESSION_ID",v="DM_SUBAGENT_SUPERVISOR_CHANNEL_DIR",P="DM_SUBAGENT_RUN_ID",k="DM_SUBAGENT_CHILD_AGENT",o="DM_SUBAGENT_CHILD_INDEX";import*as e from"node:fs";import*as _ from"node:path";var jj=[10,25,50,100,200,500,1000,2000,4000],$j=new Set(["EACCES","EBUSY","EPERM"]),h=typeof SharedArrayBuffer<"u"?new SharedArrayBuffer(4):void 0,g=h?new Int32Array(h):void 0;function fj(j){if(j<=0)return;if(g)try{Atomics.wait(g,0,0,j);return}catch{}let $=Date.now()+j;while(Date.now()<$);}function Jj(j){let $=j?.code;return typeof $==="string"&&$j.has($)}function Bj(j,$,f,J,B){for(let Z=0;;Z++)try{j.renameSync($,f);return}catch(Q){let O=J[Z];if(O===void 0||!Jj(Q))throw Q;B(O)}}function Zj(j={}){let $=j.fs??e,f=j.now??Date.now,J=j.pid??process.pid,B=j.random??Math.random,Q=j.retryRenameErrors??process.platform==="win32"?j.retryDelaysMs??jj:[],O=j.wait??fj;return(G,H)=>{$.mkdirSync(_.dirname(G),{recursive:!0});let X=_.join(_.dirname(G),`.${_.basename(G)}.${J}.${f()}.${B().toString(36).slice(2)}.tmp`);try{$.writeFileSync(X,JSON.stringify(H,null,2),"utf-8"),Bj($,X,G,Q,O)}finally{$.rmSync(X,{force:!0})}}}var R=Zj();var b=U.join(A,"supervisor-channels"),y="requests",n="replies",E="subagent_supervisor",Xj=65536,Oj=600000,Yj=Math.min(w,500),Wj=Y.Object({reason:Y.String({enum:["need_decision","interview_request","progress_update"]}),message:Y.Optional(Y.String()),interview:Y.Optional(Y.Unsafe({type:"object",additionalProperties:!0}))},{additionalProperties:!1}),d=Y.Object({action:Y.String({enum:["list","send","ask","reply","pending","status"]}),to:Y.Optional(Y.String()),message:Y.Optional(Y.String()),replyTo:Y.Optional(Y.String())},{additionalProperties:!1});function F(j){return j.trim().replace(/[^A-Za-z0-9._-]+/g,"-").replace(/^-+|-+$/g,"")||"unknown"}function c$(j,$,f){return U.join(b,`${F(j)}-${F($)}-${f}`)}function Tj(j){W.mkdirSync(U.join(j,y),{recursive:!0,mode:448}),W.mkdirSync(U.join(j,n),{recursive:!0,mode:448})}function Kj(j,$){return U.join(j,y,`${F($)}.json`)}function u(j,$){return U.join(j,n,`${F($)}.json`)}function M(j){let $=process.env[j]?.trim();return $?$:void 0}function r(){let j=M(v),$=M(P),f=M(k),J=M(o),B=M(D);if(!j||!$||!f||!B||J===void 0||!/^\d+$/.test(J))return;return{channelDir:j,runId:$,agent:f,childIndex:Number(J),orchestratorTarget:M(x),orchestratorSessionId:B,childTarget:M("DM_SUBAGENT_INTERCOM_SESSION_NAME")}}function Uj(j){if(j==="interview_request")return"Subagent requests a structured supervisor interview.";if(j==="progress_update")return"Subagent progress update.";return"Subagent needs a supervisor decision."}function Gj(j){let $=[Uj(j.reason),`Run: ${j.runId}`,`Agent: ${j.agent}`,`Child index: ${j.childIndex}`];if(j.childTarget)$.push(`Child intercom target: ${j.childTarget}`);if($.push(""),j.message?.trim())$.push(j.message.trim());if(j.reason==="interview_request"){if($.push("","Structured response requested. Reply with JSON, optionally fenced in ```json, matching the requested interview shape."),j.interview!==void 0)$.push(JSON.stringify(j.interview,null,"\t"))}return $.join(`
-`).trimEnd()}function Hj(j){let $=j.trim(),f=$.match(/^```(?:json)?\s*([\s\S]*?)\s*```$/i)?.[1]?.trim();try{return{value:JSON.parse(f??$)}}catch(J){return{error:J instanceof Error?`${J.name}: ${J.message}`:String(J)}}}function Vj(){let j=Number(process.env.PI_INTERCOM_ASK_TIMEOUT_MS);return Number.isFinite(j)&&j>0?j:Oj}function Aj(j,$){return new Promise((f,J)=>{if($?.aborted){J(Error("Supervisor request cancelled."));return}let B,Z=()=>{if(B)clearTimeout(B);$?.removeEventListener("abort",Q)},Q=()=>{Z(),J(Error("Supervisor request cancelled."))};B=setTimeout(()=>{Z(),f()},j),$?.addEventListener("abort",Q,{once:!0})})}async function _j(j,$,f){let J=u(j,$),B=Date.now()+Vj();while(Date.now()<=B){if(f?.aborted)throw Error("Supervisor request cancelled.");if(W.existsSync(J)){let Z=JSON.parse(W.readFileSync(J,"utf-8"));if(Z.type==="subagent.supervisor.reply"&&Z.requestId===$&&typeof Z.message==="string")return Z}await Aj(250,f)}throw Error("Timed out waiting for supervisor reply.")}async function N(j,$){let f=r();if(!f)throw Error("Native supervisor channel is not available for this subagent.");if(j.reason!=="progress_update"&&!j.message?.trim()&&j.reason!=="interview_request")throw Error("message is required for supervisor decisions.");Tj(f.channelDir);let J=Qj(),B=j.reason!=="progress_update",Z=Gj({...f,reason:j.reason,message:j.message,interview:j.interview}),Q={type:"subagent.supervisor.request",id:J,createdAt:Date.now(),reason:j.reason,message:Z,expectsReply:B,...f.orchestratorTarget?{orchestratorTarget:f.orchestratorTarget}:{},...f.orchestratorSessionId?{orchestratorSessionId:f.orchestratorSessionId}:{},runId:f.runId,agent:f.agent,childIndex:f.childIndex,...f.childTarget?{childTarget:f.childTarget}:{},...j.interview!==void 0?{interview:j.interview}:{}},O=JSON.stringify(Q,null,"\t");if(Buffer.byteLength(O,"utf-8")>Xj)throw Error("Supervisor request is too large.");if(R(Kj(f.channelDir,J),Q),!B)return{content:[{type:"text",text:"Supervisor progress update queued."}],details:{delivered:!0,requestId:J,reason:j.reason}};let G=await _j(f.channelDir,J,$),H={requestId:J,reason:j.reason};if(j.reason==="interview_request"){let X=Hj(G.message);if(X.error)H.structuredReplyParseError=X.error;else H.structuredReply=X.value}return{content:[{type:"text",text:`**Reply from supervisor:**
-${G.message}`}],details:H}}function S(j,$){try{return j.getAllTools?.().some((f)=>f.name===$)===!0}catch{return!1}}function q$(j,$={}){if(!r())return;let f=$.includeIntercomFallback!==!1;if(!S(j,"contact_supervisor")){let J={name:"contact_supervisor",label:"Contact Supervisor",description:"Contact the parent/supervisor session for a blocking decision, structured interview, or progress update.",parameters:Wj,execute(B,Z,Q){return N(Z,Q)}};j.registerTool(J)}if(f&&!S(j,"intercom")){let J={name:"intercom",label:"Intercom",description:"Native supervisor-channel intercom fallback for subagents. Prefer contact_supervisor when available.",parameters:d,async execute(B,Z,Q){let O=Z.action;if(O==="status")return{content:[{type:"text",text:"Native supervisor channel is active."}],details:{active:!0}};if(O==="list")return{content:[{type:"text",text:"Supervisor session available through contact_supervisor."}],details:{sessions:[]}};if(O==="send")return N({reason:"progress_update",message:Z.message??""},Q);if(O==="ask")return N({reason:"need_decision",message:Z.message??""},Q);throw Error("Native child intercom supports status, list, send, and ask. Use parent intercom reply from the supervisor session.")}};j.registerTool(J)}}function Mj(j,$){try{let f=JSON.parse(W.readFileSync(j,"utf-8"));if(f.type!=="subagent.supervisor.request")return;if(typeof f.id!=="string"||!f.id)return;if(f.reason!=="need_decision"&&f.reason!=="interview_request"&&f.reason!=="progress_update")return;if(typeof f.message!=="string"||!f.message)return;if(typeof f.runId!=="string"||typeof f.agent!=="string"||typeof f.childIndex!=="number")return;return{...f,channelDir:$,requestFile:j}}catch{return}}function Lj(){let j;try{j=W.readdirSync(b,{withFileTypes:!0})}catch(f){if(f.code==="ENOENT")return[];throw f}let $=[];for(let f of j){if(!f.isDirectory())continue;let J=U.join(b,f.name),B=U.join(J,y),Z;try{Z=W.readdirSync(B,{withFileTypes:!0})}catch{continue}for(let Q of Z)if(Q.isFile()&&Q.name.endsWith(".json"))$.push({channelDir:J,file:U.join(B,Q.name)})}return $}function Cj(j,$){try{let f=$.sessionManager.getSessionId();if(f)return f}catch{}return j.currentSessionId??void 0}function zj(j,$,f){let J=Cj($,f);return Boolean(J&&j.orchestratorSessionId===J)}function bj(j){let $=j.expectsReply?` Reply: ${E}({ action: "reply", replyTo: "${j.id}", message: "..." })`:"";return`- ${j.id}: ${j.agent} [${j.runId}#${j.childIndex}] ${j.reason}.${$}`}function Ej(j){let $=[j.message];if(j.expectsReply)$.push("",`Reply with: ${E}({ action: "reply", replyTo: "${j.id}", message: "..." })`);return $.join(`
-`)}function Fj(j,$){if(!$.trim())throw Error("message is required for supervisor replies.");let f={type:"subagent.supervisor.reply",requestId:j.id,createdAt:Date.now(),message:$.trim()};R(u(j.channelDir,j.id),f);try{W.rmSync(j.requestFile,{force:!0})}catch{}}function Sj(j,$){if($.replyTo){let J=j.get($.replyTo);if(!J)throw Error(`No pending supervisor request found for replyTo '${$.replyTo}'.`);return J}let f=[...j.values()].filter((J)=>J.expectsReply);if($.to){let J=$.to.toLowerCase(),B=f.filter((Z)=>Z.id.toLowerCase().startsWith(J)||Z.agent.toLowerCase()===J||Z.childTarget?.toLowerCase()===J);if(B.length===1)return B[0];if(B.length>1)throw Error(`Multiple pending supervisor requests match '${$.to}'. Use replyTo.`)}if(f.length===1)return f[0];if(f.length===0)throw Error("No pending supervisor requests need a reply.");throw Error("Multiple pending supervisor requests need replies. Use replyTo.")}function Rj(j){return[...j.values()].map(($)=>({id:$.id,runId:$.runId,agent:$.agent,childIndex:$.childIndex,reason:$.reason,expectsReply:$.expectsReply}))}function m(j,$="intercom"){return{name:$,label:$==="intercom"?"Intercom":"Subagent Supervisor",description:$==="intercom"?"Native dm-subagents supervisor channel. Use reply/pending/status to answer child subagent requests.":"Native dm-subagents supervisor channel. Use reply/pending/status to answer child subagent requests without overriding the optional intercom compatibility extension.",parameters:d,async execute(f,J){let B=J;if(B.action==="status")return{content:[{type:"text",text:`Native supervisor channel active. Pending replies: ${j.size}.`}],details:{active:!0,pending:j.size,root:b}};if(B.action==="pending"||B.action==="list"){let Z=[...j.values()].filter((Q)=>Q.expectsReply).map(bj);return{content:[{type:"text",text:Z.length?Z.join(`
-`):"No pending supervisor requests."}],details:{pending:Rj(j)}}}if(B.action==="reply"){let Z=Sj(j,B);return Fj(Z,B.message??""),j.delete(Z.id),{content:[{type:"text",text:`Replied to supervisor request ${Z.id}.`}],details:{replyTo:Z.id,runId:Z.runId,agent:Z.agent}}}if(B.action==="send"||B.action==="ask")throw Error("Native dm-subagents intercom currently handles supervisor replies. Child agents initiate asks with contact_supervisor.");throw Error(`Unsupported intercom action: ${B.action}`)}}}function I$(j,$){let f=new Map,J=new Set,B,Z=()=>{if(!S(j,E))j.registerTool(m(f,E));if(!S(j,"intercom"))j.registerTool(m(f))},Q=()=>{let O=$.lastUiContext;if(!O)return;for(let{channelDir:G,file:H}of Lj()){if(J.has(H))continue;let X=Mj(H,G);if(!X||!zj(X,$,O))continue;if(J.add(H),X.expectsReply)f.set(X.id,X);else try{W.rmSync(X.requestFile,{force:!0})}catch{}j.sendMessage({customType:"subagent_supervisor_request",content:Ej(X),display:!0,details:{id:X.id,reason:X.reason,expectsReply:X.expectsReply,runId:X.runId,agent:X.agent,childIndex:X.childIndex}})}};return{start:()=>{if(B)return;Z(),Q(),B=setInterval(Q,Yj),B.unref?.()},dispose:()=>{if(B)clearInterval(B);B=void 0,f.clear(),J.clear()},pending:f}}export{c$ as resolveSupervisorChannelDir,q$ as registerNativeSupervisorClient,Tj as ensureSupervisorChannelDir,I$ as createNativeSupervisorChannel,E as NATIVE_SUPERVISOR_TOOL_NAME};
+import { randomUUID } from "node:crypto";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { Type } from "typebox";
+import {
+  SUBAGENT_CHILD_AGENT_ENV,
+  SUBAGENT_CHILD_INDEX_ENV,
+  SUBAGENT_ORCHESTRATOR_SESSION_ID_ENV,
+  SUBAGENT_ORCHESTRATOR_TARGET_ENV,
+  SUBAGENT_RUN_ID_ENV,
+  SUBAGENT_SUPERVISOR_CHANNEL_DIR_ENV
+} from "../runs/shared/dm-args.js";
+import { POLL_INTERVAL_MS, TEMP_ROOT_DIR } from "../shared/types.js";
+import { writeAtomicJson } from "../shared/atomic-json.js";
+const SUPERVISOR_CHANNEL_ROOT = path.join(TEMP_ROOT_DIR, "supervisor-channels");
+const REQUESTS_DIR = "requests";
+const REPLIES_DIR = "replies";
+export const NATIVE_SUPERVISOR_TOOL_NAME = "subagent_supervisor";
+const MAX_MESSAGE_BYTES = 64 * 1024;
+const DEFAULT_ASK_TIMEOUT_MS = 10 * 60 * 1000;
+const CHANNEL_POLL_MS = Math.min(POLL_INTERVAL_MS, 500);
+const ContactSupervisorParamsSchema = Type.Object({
+  reason: Type.String({ enum: ["need_decision", "interview_request", "progress_update"] }),
+  message: Type.Optional(Type.String()),
+  interview: Type.Optional(Type.Unsafe({ type: "object", additionalProperties: true }))
+}, { additionalProperties: false });
+const IntercomParamsSchema = Type.Object({
+  action: Type.String({ enum: ["list", "send", "ask", "reply", "pending", "status"] }),
+  to: Type.Optional(Type.String()),
+  message: Type.Optional(Type.String()),
+  replyTo: Type.Optional(Type.String())
+}, { additionalProperties: false });
+function safeSegment(value) {
+  return value.trim().replace(/[^A-Za-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "") || "unknown";
+}
+export function resolveSupervisorChannelDir(runId, agent, childIndex) {
+  return path.join(SUPERVISOR_CHANNEL_ROOT, `${safeSegment(runId)}-${safeSegment(agent)}-${childIndex}`);
+}
+export function ensureSupervisorChannelDir(channelDir) {
+  fs.mkdirSync(path.join(channelDir, REQUESTS_DIR), { recursive: true, mode: 448 });
+  fs.mkdirSync(path.join(channelDir, REPLIES_DIR), { recursive: true, mode: 448 });
+}
+function requestPath(channelDir, requestId) {
+  return path.join(channelDir, REQUESTS_DIR, `${safeSegment(requestId)}.json`);
+}
+function replyPath(channelDir, requestId) {
+  return path.join(channelDir, REPLIES_DIR, `${safeSegment(requestId)}.json`);
+}
+function readTextEnv(name) {
+  const value = process.env[name]?.trim();
+  return value ? value : undefined;
+}
+function readChildMetadata() {
+  const channelDir = readTextEnv(SUBAGENT_SUPERVISOR_CHANNEL_DIR_ENV);
+  const runId = readTextEnv(SUBAGENT_RUN_ID_ENV);
+  const agent = readTextEnv(SUBAGENT_CHILD_AGENT_ENV);
+  const rawIndex = readTextEnv(SUBAGENT_CHILD_INDEX_ENV);
+  const orchestratorSessionId = readTextEnv(SUBAGENT_ORCHESTRATOR_SESSION_ID_ENV);
+  if (!channelDir || !runId || !agent || !orchestratorSessionId || rawIndex === undefined || !/^\d+$/.test(rawIndex))
+    return;
+  return {
+    channelDir,
+    runId,
+    agent,
+    childIndex: Number(rawIndex),
+    orchestratorTarget: readTextEnv(SUBAGENT_ORCHESTRATOR_TARGET_ENV),
+    orchestratorSessionId,
+    childTarget: readTextEnv("DM_SUBAGENT_INTERCOM_SESSION_NAME")
+  };
+}
+function reasonHeading(reason) {
+  if (reason === "interview_request")
+    return "Subagent requests a structured supervisor interview.";
+  if (reason === "progress_update")
+    return "Subagent progress update.";
+  return "Subagent needs a supervisor decision.";
+}
+function formatChildMessage(input) {
+  const lines = [
+    reasonHeading(input.reason),
+    `Run: ${input.runId}`,
+    `Agent: ${input.agent}`,
+    `Child index: ${input.childIndex}`
+  ];
+  if (input.childTarget)
+    lines.push(`Child intercom target: ${input.childTarget}`);
+  lines.push("");
+  if (input.message?.trim())
+    lines.push(input.message.trim());
+  if (input.reason === "interview_request") {
+    lines.push("", "Structured response requested. Reply with JSON, optionally fenced in ```json, matching the requested interview shape.");
+    if (input.interview !== undefined)
+      lines.push(JSON.stringify(input.interview, null, "\t"));
+  }
+  return lines.join(`
+`).trimEnd();
+}
+function parseStructuredReply(message) {
+  const trimmed = message.trim();
+  const fenced = trimmed.match(/^```(?:json)?\s*([\s\S]*?)\s*```$/i)?.[1]?.trim();
+  try {
+    return { value: JSON.parse(fenced ?? trimmed) };
+  } catch (error) {
+    return { error: error instanceof Error ? `${error.name}: ${error.message}` : String(error) };
+  }
+}
+function askTimeoutMs() {
+  const parsed = Number(process.env.PI_INTERCOM_ASK_TIMEOUT_MS);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : DEFAULT_ASK_TIMEOUT_MS;
+}
+function delay(ms, signal) {
+  return new Promise((resolve, reject) => {
+    if (signal?.aborted) {
+      reject(new Error("Supervisor request cancelled."));
+      return;
+    }
+    let timer;
+    const cleanup = () => {
+      if (timer)
+        clearTimeout(timer);
+      signal?.removeEventListener("abort", onAbort);
+    };
+    const onAbort = () => {
+      cleanup();
+      reject(new Error("Supervisor request cancelled."));
+    };
+    timer = setTimeout(() => {
+      cleanup();
+      resolve();
+    }, ms);
+    signal?.addEventListener("abort", onAbort, { once: true });
+  });
+}
+async function waitForReply(channelDir, requestId, signal) {
+  const file = replyPath(channelDir, requestId);
+  const deadline = Date.now() + askTimeoutMs();
+  while (Date.now() <= deadline) {
+    if (signal?.aborted)
+      throw new Error("Supervisor request cancelled.");
+    if (fs.existsSync(file)) {
+      const parsed = JSON.parse(fs.readFileSync(file, "utf-8"));
+      if (parsed.type === "subagent.supervisor.reply" && parsed.requestId === requestId && typeof parsed.message === "string") {
+        return parsed;
+      }
+    }
+    await delay(250, signal);
+  }
+  throw new Error("Timed out waiting for supervisor reply.");
+}
+async function sendSupervisorRequest(params, signal) {
+  const metadata = readChildMetadata();
+  if (!metadata)
+    throw new Error("Native supervisor channel is not available for this subagent.");
+  if (params.reason !== "progress_update" && !params.message?.trim() && params.reason !== "interview_request") {
+    throw new Error("message is required for supervisor decisions.");
+  }
+  ensureSupervisorChannelDir(metadata.channelDir);
+  const requestId = randomUUID();
+  const expectsReply = params.reason !== "progress_update";
+  const message = formatChildMessage({ ...metadata, reason: params.reason, message: params.message, interview: params.interview });
+  const request = {
+    type: "subagent.supervisor.request",
+    id: requestId,
+    createdAt: Date.now(),
+    reason: params.reason,
+    message,
+    expectsReply,
+    ...metadata.orchestratorTarget ? { orchestratorTarget: metadata.orchestratorTarget } : {},
+    ...metadata.orchestratorSessionId ? { orchestratorSessionId: metadata.orchestratorSessionId } : {},
+    runId: metadata.runId,
+    agent: metadata.agent,
+    childIndex: metadata.childIndex,
+    ...metadata.childTarget ? { childTarget: metadata.childTarget } : {},
+    ...params.interview !== undefined ? { interview: params.interview } : {}
+  };
+  const serialized = JSON.stringify(request, null, "\t");
+  if (Buffer.byteLength(serialized, "utf-8") > MAX_MESSAGE_BYTES)
+    throw new Error("Supervisor request is too large.");
+  writeAtomicJson(requestPath(metadata.channelDir, requestId), request);
+  if (!expectsReply) {
+    return {
+      content: [{ type: "text", text: "Supervisor progress update queued." }],
+      details: { delivered: true, requestId, reason: params.reason }
+    };
+  }
+  const reply = await waitForReply(metadata.channelDir, requestId, signal);
+  const details = { requestId, reason: params.reason };
+  if (params.reason === "interview_request") {
+    const structured = parseStructuredReply(reply.message);
+    if (structured.error)
+      details.structuredReplyParseError = structured.error;
+    else
+      details.structuredReply = structured.value;
+  }
+  return {
+    content: [{ type: "text", text: `**Reply from supervisor:**
+${reply.message}` }],
+    details
+  };
+}
+function hasTool(pi, name) {
+  try {
+    return pi.getAllTools?.().some((tool) => tool.name === name) === true;
+  } catch {
+    return false;
+  }
+}
+export function registerNativeSupervisorClient(pi, options = {}) {
+  if (!readChildMetadata())
+    return;
+  const includeIntercomFallback = options.includeIntercomFallback !== false;
+  if (!hasTool(pi, "contact_supervisor")) {
+    const tool = {
+      name: "contact_supervisor",
+      label: "Contact Supervisor",
+      description: "Contact the parent/supervisor session for a blocking decision, structured interview, or progress update.",
+      parameters: ContactSupervisorParamsSchema,
+      execute(_id, params, signal) {
+        return sendSupervisorRequest(params, signal);
+      }
+    };
+    pi.registerTool(tool);
+  }
+  if (includeIntercomFallback && !hasTool(pi, "intercom")) {
+    const tool = {
+      name: "intercom",
+      label: "Intercom",
+      description: "Native supervisor-channel intercom fallback for subagents. Prefer contact_supervisor when available.",
+      parameters: IntercomParamsSchema,
+      async execute(_id, params, signal) {
+        const action = params.action;
+        if (action === "status")
+          return { content: [{ type: "text", text: "Native supervisor channel is active." }], details: { active: true } };
+        if (action === "list")
+          return { content: [{ type: "text", text: "Supervisor session available through contact_supervisor." }], details: { sessions: [] } };
+        if (action === "send")
+          return sendSupervisorRequest({ reason: "progress_update", message: params.message ?? "" }, signal);
+        if (action === "ask")
+          return sendSupervisorRequest({ reason: "need_decision", message: params.message ?? "" }, signal);
+        throw new Error("Native child intercom supports status, list, send, and ask. Use parent intercom reply from the supervisor session.");
+      }
+    };
+    pi.registerTool(tool);
+  }
+}
+function parseRequestFile(file, channelDir) {
+  try {
+    const parsed = JSON.parse(fs.readFileSync(file, "utf-8"));
+    if (parsed.type !== "subagent.supervisor.request")
+      return;
+    if (typeof parsed.id !== "string" || !parsed.id)
+      return;
+    if (parsed.reason !== "need_decision" && parsed.reason !== "interview_request" && parsed.reason !== "progress_update")
+      return;
+    if (typeof parsed.message !== "string" || !parsed.message)
+      return;
+    if (typeof parsed.runId !== "string" || typeof parsed.agent !== "string" || typeof parsed.childIndex !== "number")
+      return;
+    return { ...parsed, channelDir, requestFile: file };
+  } catch {
+    return;
+  }
+}
+function listRequestFiles() {
+  let channelEntries;
+  try {
+    channelEntries = fs.readdirSync(SUPERVISOR_CHANNEL_ROOT, { withFileTypes: true });
+  } catch (error) {
+    if (error.code === "ENOENT")
+      return [];
+    throw error;
+  }
+  const files = [];
+  for (const entry of channelEntries) {
+    if (!entry.isDirectory())
+      continue;
+    const channelDir = path.join(SUPERVISOR_CHANNEL_ROOT, entry.name);
+    const requestsDir = path.join(channelDir, REQUESTS_DIR);
+    let requestEntries;
+    try {
+      requestEntries = fs.readdirSync(requestsDir, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const requestEntry of requestEntries) {
+      if (requestEntry.isFile() && requestEntry.name.endsWith(".json"))
+        files.push({ channelDir, file: path.join(requestsDir, requestEntry.name) });
+    }
+  }
+  return files;
+}
+function currentContextSessionId(state, ctx) {
+  try {
+    const sessionId = ctx.sessionManager.getSessionId();
+    if (sessionId)
+      return sessionId;
+  } catch {}
+  return state.currentSessionId ?? undefined;
+}
+function requestMatchesContext(request, state, ctx) {
+  const currentSessionId = currentContextSessionId(state, ctx);
+  return Boolean(currentSessionId && request.orchestratorSessionId === currentSessionId);
+}
+function formatPendingLine(request) {
+  const replyHint = request.expectsReply ? ` Reply: ${NATIVE_SUPERVISOR_TOOL_NAME}({ action: "reply", replyTo: "${request.id}", message: "..." })` : "";
+  return `- ${request.id}: ${request.agent} [${request.runId}#${request.childIndex}] ${request.reason}.${replyHint}`;
+}
+function requestVisibleText(request) {
+  const lines = [request.message];
+  if (request.expectsReply) {
+    lines.push("", `Reply with: ${NATIVE_SUPERVISOR_TOOL_NAME}({ action: "reply", replyTo: "${request.id}", message: "..." })`);
+  }
+  return lines.join(`
+`);
+}
+function writeReply(request, message) {
+  if (!message.trim())
+    throw new Error("message is required for supervisor replies.");
+  const reply = {
+    type: "subagent.supervisor.reply",
+    requestId: request.id,
+    createdAt: Date.now(),
+    message: message.trim()
+  };
+  writeAtomicJson(replyPath(request.channelDir, request.id), reply);
+  try {
+    fs.rmSync(request.requestFile, { force: true });
+  } catch {}
+}
+function resolvePendingRequest(pending, params) {
+  if (params.replyTo) {
+    const request = pending.get(params.replyTo);
+    if (!request)
+      throw new Error(`No pending supervisor request found for replyTo '${params.replyTo}'.`);
+    return request;
+  }
+  const requests = [...pending.values()].filter((request) => request.expectsReply);
+  if (params.to) {
+    const normalizedTo = params.to.toLowerCase();
+    const matches = requests.filter((request) => request.id.toLowerCase().startsWith(normalizedTo) || request.agent.toLowerCase() === normalizedTo || request.childTarget?.toLowerCase() === normalizedTo);
+    if (matches.length === 1)
+      return matches[0];
+    if (matches.length > 1)
+      throw new Error(`Multiple pending supervisor requests match '${params.to}'. Use replyTo.`);
+  }
+  if (requests.length === 1)
+    return requests[0];
+  if (requests.length === 0)
+    throw new Error("No pending supervisor requests need a reply.");
+  throw new Error("Multiple pending supervisor requests need replies. Use replyTo.");
+}
+function publicPendingRequests(pending) {
+  return [...pending.values()].map((request) => ({
+    id: request.id,
+    runId: request.runId,
+    agent: request.agent,
+    childIndex: request.childIndex,
+    reason: request.reason,
+    expectsReply: request.expectsReply
+  }));
+}
+function buildParentIntercomTool(pending, name = "intercom") {
+  return {
+    name,
+    label: name === "intercom" ? "Intercom" : "Subagent Supervisor",
+    description: name === "intercom" ? "Native dm-subagents supervisor channel. Use reply/pending/status to answer child subagent requests." : "Native dm-subagents supervisor channel. Use reply/pending/status to answer child subagent requests without overriding the optional intercom compatibility extension.",
+    parameters: IntercomParamsSchema,
+    async execute(_id, params) {
+      const input = params;
+      if (input.action === "status") {
+        return { content: [{ type: "text", text: `Native supervisor channel active. Pending replies: ${pending.size}.` }], details: { active: true, pending: pending.size, root: SUPERVISOR_CHANNEL_ROOT } };
+      }
+      if (input.action === "pending" || input.action === "list") {
+        const lines = [...pending.values()].filter((request) => request.expectsReply).map(formatPendingLine);
+        return { content: [{ type: "text", text: lines.length ? lines.join(`
+`) : "No pending supervisor requests." }], details: { pending: publicPendingRequests(pending) } };
+      }
+      if (input.action === "reply") {
+        const request = resolvePendingRequest(pending, input);
+        writeReply(request, input.message ?? "");
+        pending.delete(request.id);
+        return { content: [{ type: "text", text: `Replied to supervisor request ${request.id}.` }], details: { replyTo: request.id, runId: request.runId, agent: request.agent } };
+      }
+      if (input.action === "send" || input.action === "ask") {
+        throw new Error("Native dm-subagents intercom currently handles supervisor replies. Child agents initiate asks with contact_supervisor.");
+      }
+      throw new Error(`Unsupported intercom action: ${input.action}`);
+    }
+  };
+}
+export function createNativeSupervisorChannel(pi, state) {
+  const pending = new Map;
+  const seenFiles = new Set;
+  let poller;
+  const registerParentTools = () => {
+    if (!hasTool(pi, NATIVE_SUPERVISOR_TOOL_NAME))
+      pi.registerTool(buildParentIntercomTool(pending, NATIVE_SUPERVISOR_TOOL_NAME));
+    if (!hasTool(pi, "intercom"))
+      pi.registerTool(buildParentIntercomTool(pending));
+  };
+  const poll = () => {
+    const ctx = state.lastUiContext;
+    if (!ctx)
+      return;
+    for (const { channelDir, file } of listRequestFiles()) {
+      if (seenFiles.has(file))
+        continue;
+      const request = parseRequestFile(file, channelDir);
+      if (!request || !requestMatchesContext(request, state, ctx))
+        continue;
+      seenFiles.add(file);
+      if (request.expectsReply)
+        pending.set(request.id, request);
+      else {
+        try {
+          fs.rmSync(request.requestFile, { force: true });
+        } catch {}
+      }
+      pi.sendMessage({
+        customType: "subagent_supervisor_request",
+        content: requestVisibleText(request),
+        display: true,
+        details: {
+          id: request.id,
+          reason: request.reason,
+          expectsReply: request.expectsReply,
+          runId: request.runId,
+          agent: request.agent,
+          childIndex: request.childIndex
+        }
+      });
+    }
+  };
+  return {
+    start: () => {
+      if (poller)
+        return;
+      registerParentTools();
+      poll();
+      poller = setInterval(poll, CHANNEL_POLL_MS);
+      poller.unref?.();
+    },
+    dispose: () => {
+      if (poller)
+        clearInterval(poller);
+      poller = undefined;
+      pending.clear();
+      seenFiles.clear();
+    },
+    pending
+  };
+}