@duckmind/dm-windows-x64 0.60.6 → 0.60.9

package/extensions/dm-subagents/src/extension/schemas.js

@@ -1 +1,275 @@
-import{Type as f}from"typebox";function V(q){return X(q,[])}function X(q,R){if(!q||typeof q!=="object")return q;let U=Array.isArray(q)?[]:Object.create(Object.getPrototypeOf(q));for(let w of Reflect.ownKeys(q)){let z=Object.getOwnPropertyDescriptor(q,w);if(!z)continue;if(w==="description"&&!Z(R))continue;if("value"in z){let Y=typeof w==="string"?[...R,w]:R;z.value=X(z.value,Y)}Object.defineProperty(U,w,z)}return U}function Z(q){return q.length===2&&q[0]==="properties"}var E=f.Unsafe({anyOf:[{type:"array",items:{type:"string"}},{type:"boolean"},{type:"string"}],description:"Skill name(s) to make available (comma-separated), array of strings, or boolean (false disables, true uses default)"}),K=f.Unsafe({anyOf:[{type:"string"},{type:"boolean"}],description:"Output filename/path (string), or false to disable file output"}),F=f.String({enum:["inline","file-only"],description:"Return saved output inline (default) or only a concise file reference. file-only requires output to be a path."}),M=f.Unsafe({anyOf:[{type:"array",items:{type:"string"}},{type:"boolean"}],description:"Files to read before running (array of filenames), or false to disable"}),Q=f.Unsafe({type:"object",additionalProperties:!0,description:"JSON Schema object for strict structured output. Non-object roots are rejected."}),G=f.Unsafe({anyOf:[{type:"string",enum:["auto","none","attested","checked","verified","reviewed"]},{type:"boolean",enum:[!1]},{type:"object",additionalProperties:!0}],description:"Optional acceptance policy. Omitted means auto-inferred; verified requires configured runtime commands."}),_=f.Object({maxTurns:f.Integer({minimum:1}),graceTurns:f.Optional(f.Integer({minimum:0}))},{additionalProperties:!1,description:"Optional assistant-turn budget. At maxTurns the child is asked to wrap up; after graceTurns additional assistant turns it is aborted and partial output is returned."}),$=f.Unsafe({anyOf:[{type:"array",minItems:1,items:{type:"string",minLength:1}},{type:"string",enum:["*"]}]}),H=f.Object({soft:f.Optional(f.Integer({minimum:1})),hard:f.Integer({minimum:1}),block:f.Optional($)},{additionalProperties:!1,description:"Optional child tool-call budget. soft nudges the child; after hard, block tools (default read/grep/find/ls, or '*' for all tools) are blocked so the child can finalize."}),g=f.Object({agent:f.String(),task:f.String(),cwd:f.Optional(f.String()),count:f.Optional(f.Integer({minimum:1,description:"Repeat this parallel task N times with the same settings."})),output:f.Optional(K),outputMode:f.Optional(F),reads:f.Optional(M),progress:f.Optional(f.Boolean({description:"Enable progress.md tracking for this task"})),model:f.Optional(f.String({description:"Override model for this task (e.g. 'google/gemini-3-pro')"})),skill:f.Optional(E),toolBudget:f.Optional(H),acceptance:f.Optional(G)}),x=f.Object({agent:f.String(),task:f.Optional(f.String({description:"Task template with {task}, {previous}, {chain_dir} variables. Defaults to {previous}."})),phase:f.Optional(f.String({description:"Optional phase/group label for status and graph rendering."})),label:f.Optional(f.String({description:"Optional user-facing label for this parallel task."})),as:f.Optional(f.String({description:"Optional safe identifier used as {outputs.name} in later chain steps."})),outputSchema:f.Optional(Q),cwd:f.Optional(f.String()),count:f.Optional(f.Integer({minimum:1,description:"Repeat this parallel task N times with the same settings."})),output:f.Optional(K),outputMode:f.Optional(F),reads:f.Optional(M),progress:f.Optional(f.Boolean({description:"Enable progress.md tracking in {chain_dir}"})),skill:f.Optional(E),model:f.Optional(f.String({description:"Override model for this task"})),toolBudget:f.Optional(H),acceptance:f.Optional(G)}),C=f.Object({from:f.Object({output:f.String({description:"Prior named structured output to expand from."}),path:f.String({description:"JSON Pointer into the structured output, e.g. /items."})},{additionalProperties:!1}),item:f.Optional(f.String({description:"Template variable name for each item. Defaults to item."})),key:f.Optional(f.String({description:"JSON Pointer relative to each item for stable child ids."})),maxItems:f.Optional(f.Integer({minimum:0,description:"Required fanout bound unless configured globally."})),onEmpty:f.Optional(f.String({enum:["skip","fail"],description:"Empty input behavior. Defaults to skip."}))},{additionalProperties:!1}),I=f.Object({agent:f.String(),task:f.Optional(f.String({description:"Task template with {item}, {item.path}, {task}, {previous}, {chain_dir}, and {outputs.name} variables."})),phase:f.Optional(f.String({description:"Optional phase/group label for status and graph rendering."})),label:f.Optional(f.String({description:"Optional user-facing label; item templates are supported."})),outputSchema:f.Optional(Q),cwd:f.Optional(f.String()),output:f.Optional(K),outputMode:f.Optional(F),reads:f.Optional(M),progress:f.Optional(f.Boolean({description:"Enable progress.md tracking in {chain_dir}"})),skill:f.Optional(E),model:f.Optional(f.String({description:"Override model for this task"})),toolBudget:f.Optional(H),acceptance:f.Optional(G)},{additionalProperties:!1}),W=f.Object({as:f.String({description:"Safe output name for the ordered collected result array."}),outputSchema:f.Optional(Q)},{additionalProperties:!1}),B=f.Object({agent:f.Optional(f.String({description:"Sequential step agent name"})),task:f.Optional(f.String({description:"Task template with variables: {task}=original request, {previous}=prior step's text response, {chain_dir}=shared folder, {outputs.name}=prior named output. Required for first step, defaults to '{previous}' for subsequent steps."})),phase:f.Optional(f.String({description:"Optional phase/group label for status and graph rendering."})),label:f.Optional(f.String({description:"Optional user-facing label for this chain step."})),as:f.Optional(f.String({description:"Optional safe identifier used as {outputs.name} in later chain steps."})),outputSchema:f.Optional(Q),cwd:f.Optional(f.String()),output:f.Optional(K),outputMode:f.Optional(F),reads:f.Optional(M),progress:f.Optional(f.Boolean({description:"Enable progress.md tracking in {chain_dir}"})),skill:f.Optional(E),model:f.Optional(f.String({description:"Override model for this step"})),toolBudget:f.Optional(H),acceptance:f.Optional(G),parallel:f.Optional(f.Unsafe({anyOf:[f.Array(x,{minItems:1,description:"Tasks to run in parallel"}),I],description:"Static parallel tasks array, or a single dynamic fanout child template when expand/collect are present."})),expand:f.Optional(C),collect:f.Optional(W),concurrency:f.Optional(f.Number({description:"Max concurrent tasks (default: 4)"})),failFast:f.Optional(f.Boolean({description:"Stop on first failure (default: false)"})),worktree:f.Optional(f.Boolean({description:"Create isolated git worktrees for each parallel task."}))},{description:"Chain step: use {agent, task?, ...} for sequential, {parallel: [...]} for static concurrent execution, or {expand, parallel: {...}, collect} for dynamic fanout.",additionalProperties:!1}),L=f.Object({enabled:f.Optional(f.Boolean({description:"Enable/disable subagent control attention tracking for this run"})),needsAttentionAfterMs:f.Optional(f.Integer({minimum:1,description:"No-observed-activity window before a run needs attention"})),activeNoticeAfterMs:f.Optional(f.Integer({minimum:1,description:"Active-long-running notice threshold by elapsed ms (default: 240000)"})),activeNoticeAfterTurns:f.Optional(f.Integer({minimum:1,description:"Optional active-long-running notice threshold by assistant turns (disabled by default)"})),activeNoticeAfterTokens:f.Optional(f.Integer({minimum:1,description:"Optional active-long-running notice threshold by total tokens (disabled by default)"})),failedToolAttemptsBeforeAttention:f.Optional(f.Integer({minimum:1,description:"Consecutive mutating-tool failures before escalating to needs_attention (default: 3)"})),notifyOn:f.Optional(f.Array(f.String({enum:["active_long_running","needs_attention"]}),{description:"Control event types that should notify the parent/orchestrator. Defaults to active_long_running and needs_attention."})),notifyChannels:f.Optional(f.Array(f.String({enum:["event","async","intercom"]}),{description:"Notification channels to use when available. Defaults to event, async, and intercom."}))}),N=f.Object({agent:f.Optional(f.String({description:"Agent name (SINGLE mode) or target for management get/update/delete"})),task:f.Optional(f.String({description:"Task (SINGLE mode, optional for self-contained agents)"})),action:f.Optional(f.String({description:"Management/control action only. Must be omitted for execution mode (single, parallel, or chain)."})),id:f.Optional(f.String({description:"Run id or prefix for action='status', action='interrupt', action='resume', action='steer', or action='append-step'."})),runId:f.Optional(f.String({description:"Target run ID for action='interrupt', action='resume', action='steer', or action='append-step'. Defaults to the most recently active controllable run for interrupt. Prefer id for new calls."})),dir:f.Optional(f.String({description:"Async run directory for action='status', action='resume', or action='steer'."})),index:f.Optional(f.Integer({minimum:0,description:"Zero-based child index for actions that target a specific child or transcript."})),view:f.Optional(f.String({enum:["fleet","transcript"],description:"Optional status view. Use view='fleet' for a read-only active foreground/async fleet surface, or view='transcript' with id/dir (and optional index) to tail a run transcript."})),lines:f.Optional(f.Integer({minimum:1,maximum:500,description:"Maximum transcript lines for action='status', view='transcript'. Defaults to 80."})),message:f.Optional(f.String({description:"Follow-up message for action='resume' or non-terminal guidance for action='steer'. Use index to choose a child from multi-child runs."})),schedule:f.Optional(f.String({description:"Explicit one-shot schedule for action='schedule'. Only honored when scheduledRuns.enabled is true. Use '+10m' or a future ISO timestamp with timezone; scheduled runs always launch async with fresh context."})),scheduleName:f.Optional(f.String({description:"Optional display name for action='schedule'."})),chainName:f.Optional(f.String({description:"Chain name for get/update/delete management actions"})),config:f.Optional(f.Unsafe({anyOf:[{type:"object",additionalProperties:!0},{type:"string"}],description:"Agent/chain config for create/update. Object or JSON string; presence of steps creates a chain."})),tasks:f.Optional(f.Array(g,{description:"PARALLEL mode: [{agent, task, count?, output?, outputMode?, reads?, progress?}, ...]"})),concurrency:f.Optional(f.Integer({minimum:1,description:"Top-level PARALLEL mode only: max concurrent tasks. Defaults to config.parallel.concurrency or 4."})),worktree:f.Optional(f.Boolean({description:"Create isolated git worktrees for parallel tasks; requires clean git state."})),chain:f.Optional(f.Array(B,{description:"CHAIN mode: sequential steps; each result becomes {previous}. append-step takes one tail step and may use {chain_dir}/{outputs.name}."})),context:f.Optional(f.String({enum:["fresh","fork"],description:"'fresh' or 'fork' to branch from parent session. Explicit context overrides every child in the invocation. If omitted, each requested agent uses its own defaultContext; agents without defaultContext: 'fork' run fresh."})),chainDir:f.Optional(f.String({description:"Persistent chain artifact directory; defaults to user-scoped temp storage."})),async:f.Optional(f.Boolean({description:"Run in background (default: false, or per config)"})),timeoutMs:f.Optional(f.Integer({minimum:1,description:"Optional run-level timeout in ms for foreground and async/background runs. Alias of maxRuntimeMs."})),maxRuntimeMs:f.Optional(f.Integer({minimum:1,description:"Alias of timeoutMs for optional run-level timeout in foreground and async/background runs."})),turnBudget:f.Optional(_),toolBudget:f.Optional(H),agentScope:f.Optional(f.String({description:"Agent discovery scope: 'user', 'project', or 'both' (default: 'both'; project wins on name collisions)"})),cwd:f.Optional(f.String()),artifacts:f.Optional(f.Boolean({description:"Write debug artifacts (default: true)"})),includeProgress:f.Optional(f.Boolean({description:"Include full progress in result (default: false)"})),share:f.Optional(f.Boolean({description:"Upload session to GitHub Gist for sharing (default: false)"})),sessionDir:f.Optional(f.String({description:"Directory to store session logs (default: temp; enables sessions even if share=false)"})),clarify:f.Optional(f.Boolean({description:"Show TUI to preview/edit before execution. Explicit clarify: true keeps the run foreground for the clarify UI; omitted clarify can still run in the background when async: true is set."})),control:f.Optional(L),output:f.Optional(f.Unsafe({anyOf:[{type:"string"},{type:"boolean"}],description:"Output file for single agent (string), or false to disable. Relative paths resolve against cwd."})),outputMode:f.Optional(F),skill:f.Optional(E),model:f.Optional(f.String({description:"Override model for single agent (e.g. 'anthropic/claude-sonnet-4')"})),acceptance:f.Optional(G)}),j=V(N),T=f.Object({id:f.Optional(f.String({description:"Run id or prefix to wait for one specific run. Omit to wait across every active async run started in this session."})),all:f.Optional(f.Boolean({description:"Wait for ALL active runs to finish. Default false: return as soon as the first run finishes, so a fleet manager can spawn a replacement and wait again. Ignored when id targets a single run."})),timeoutMs:f.Optional(f.Integer({minimum:1,description:"Give up waiting after this many milliseconds (the runs keep going regardless). Defaults to 1800000 (30 minutes)."}))}),D=V(T);export{D as WaitParams,j as SubagentParams};
+import { Type } from "typebox";
+function keepTopLevelParameterDescriptions(schema) {
+  return pruneNestedDescriptions(schema, []);
+}
+function pruneNestedDescriptions(value, path) {
+  if (!value || typeof value !== "object")
+    return value;
+  const result = Array.isArray(value) ? [] : Object.create(Object.getPrototypeOf(value));
+  for (const key of Reflect.ownKeys(value)) {
+    const descriptor = Object.getOwnPropertyDescriptor(value, key);
+    if (!descriptor)
+      continue;
+    if (key === "description" && !isTopLevelParameterDescription(path))
+      continue;
+    if ("value" in descriptor) {
+      const nextPath = typeof key === "string" ? [...path, key] : path;
+      descriptor.value = pruneNestedDescriptions(descriptor.value, nextPath);
+    }
+    Object.defineProperty(result, key, descriptor);
+  }
+  return result;
+}
+function isTopLevelParameterDescription(path) {
+  return path.length === 2 && path[0] === "properties";
+}
+const SkillOverride = Type.Unsafe({
+  anyOf: [
+    { type: "array", items: { type: "string" } },
+    { type: "boolean" },
+    { type: "string" }
+  ],
+  description: "Skill name(s) to make available (comma-separated), array of strings, or boolean (false disables, true uses default)"
+});
+const OutputOverride = Type.Unsafe({
+  anyOf: [
+    { type: "string" },
+    { type: "boolean" }
+  ],
+  description: "Output filename/path (string), or false to disable file output"
+});
+const OutputModeOverride = Type.String({
+  enum: ["inline", "file-only"],
+  description: "Return saved output inline (default) or only a concise file reference. file-only requires output to be a path."
+});
+const ReadsOverride = Type.Unsafe({
+  anyOf: [
+    { type: "array", items: { type: "string" } },
+    { type: "boolean" }
+  ],
+  description: "Files to read before running (array of filenames), or false to disable"
+});
+const JsonSchemaObject = Type.Unsafe({
+  type: "object",
+  additionalProperties: true,
+  description: "JSON Schema object for strict structured output. Non-object roots are rejected."
+});
+const AcceptanceOverride = Type.Unsafe({
+  anyOf: [
+    { type: "string", enum: ["auto", "none", "attested", "checked", "verified", "reviewed"] },
+    { type: "boolean", enum: [false] },
+    { type: "object", additionalProperties: true }
+  ],
+  description: "Optional acceptance policy. Omitted means auto-inferred; verified requires configured runtime commands."
+});
+const TurnBudgetOverride = Type.Object({
+  maxTurns: Type.Integer({ minimum: 1 }),
+  graceTurns: Type.Optional(Type.Integer({ minimum: 0 }))
+}, { additionalProperties: false, description: "Optional assistant-turn budget. At maxTurns the child is asked to wrap up; after graceTurns additional assistant turns it is aborted and partial output is returned." });
+const ToolBudgetBlock = Type.Unsafe({
+  anyOf: [
+    { type: "array", minItems: 1, items: { type: "string", minLength: 1 } },
+    { type: "string", enum: ["*"] }
+  ]
+});
+const ToolBudgetOverride = Type.Object({
+  soft: Type.Optional(Type.Integer({ minimum: 1 })),
+  hard: Type.Integer({ minimum: 1 }),
+  block: Type.Optional(ToolBudgetBlock)
+}, { additionalProperties: false, description: "Optional child tool-call budget. soft nudges the child; after hard, block tools (default read/grep/find/ls, or '*' for all tools) are blocked so the child can finalize." });
+const TaskItem = Type.Object({
+  agent: Type.String(),
+  task: Type.String(),
+  cwd: Type.Optional(Type.String()),
+  count: Type.Optional(Type.Integer({ minimum: 1, description: "Repeat this parallel task N times with the same settings." })),
+  output: Type.Optional(OutputOverride),
+  outputMode: Type.Optional(OutputModeOverride),
+  reads: Type.Optional(ReadsOverride),
+  progress: Type.Optional(Type.Boolean({ description: "Enable progress.md tracking for this task" })),
+  model: Type.Optional(Type.String({ description: "Override model for this task (e.g. 'google/gemini-3-pro')" })),
+  skill: Type.Optional(SkillOverride),
+  toolBudget: Type.Optional(ToolBudgetOverride),
+  acceptance: Type.Optional(AcceptanceOverride)
+});
+const ParallelTaskSchema = Type.Object({
+  agent: Type.String(),
+  task: Type.Optional(Type.String({ description: "Task template with {task}, {previous}, {chain_dir} variables. Defaults to {previous}." })),
+  phase: Type.Optional(Type.String({ description: "Optional phase/group label for status and graph rendering." })),
+  label: Type.Optional(Type.String({ description: "Optional user-facing label for this parallel task." })),
+  as: Type.Optional(Type.String({ description: "Optional safe identifier used as {outputs.name} in later chain steps." })),
+  outputSchema: Type.Optional(JsonSchemaObject),
+  cwd: Type.Optional(Type.String()),
+  count: Type.Optional(Type.Integer({ minimum: 1, description: "Repeat this parallel task N times with the same settings." })),
+  output: Type.Optional(OutputOverride),
+  outputMode: Type.Optional(OutputModeOverride),
+  reads: Type.Optional(ReadsOverride),
+  progress: Type.Optional(Type.Boolean({ description: "Enable progress.md tracking in {chain_dir}" })),
+  skill: Type.Optional(SkillOverride),
+  model: Type.Optional(Type.String({ description: "Override model for this task" })),
+  toolBudget: Type.Optional(ToolBudgetOverride),
+  acceptance: Type.Optional(AcceptanceOverride)
+});
+const DynamicExpandSchema = Type.Object({
+  from: Type.Object({
+    output: Type.String({ description: "Prior named structured output to expand from." }),
+    path: Type.String({ description: "JSON Pointer into the structured output, e.g. /items." })
+  }, { additionalProperties: false }),
+  item: Type.Optional(Type.String({ description: "Template variable name for each item. Defaults to item." })),
+  key: Type.Optional(Type.String({ description: "JSON Pointer relative to each item for stable child ids." })),
+  maxItems: Type.Optional(Type.Integer({ minimum: 0, description: "Required fanout bound unless configured globally." })),
+  onEmpty: Type.Optional(Type.String({ enum: ["skip", "fail"], description: "Empty input behavior. Defaults to skip." }))
+}, { additionalProperties: false });
+const DynamicParallelTemplateSchema = Type.Object({
+  agent: Type.String(),
+  task: Type.Optional(Type.String({ description: "Task template with {item}, {item.path}, {task}, {previous}, {chain_dir}, and {outputs.name} variables." })),
+  phase: Type.Optional(Type.String({ description: "Optional phase/group label for status and graph rendering." })),
+  label: Type.Optional(Type.String({ description: "Optional user-facing label; item templates are supported." })),
+  outputSchema: Type.Optional(JsonSchemaObject),
+  cwd: Type.Optional(Type.String()),
+  output: Type.Optional(OutputOverride),
+  outputMode: Type.Optional(OutputModeOverride),
+  reads: Type.Optional(ReadsOverride),
+  progress: Type.Optional(Type.Boolean({ description: "Enable progress.md tracking in {chain_dir}" })),
+  skill: Type.Optional(SkillOverride),
+  model: Type.Optional(Type.String({ description: "Override model for this task" })),
+  toolBudget: Type.Optional(ToolBudgetOverride),
+  acceptance: Type.Optional(AcceptanceOverride)
+}, { additionalProperties: false });
+const DynamicCollectSchema = Type.Object({
+  as: Type.String({ description: "Safe output name for the ordered collected result array." }),
+  outputSchema: Type.Optional(JsonSchemaObject)
+}, { additionalProperties: false });
+const ChainItem = Type.Object({
+  agent: Type.Optional(Type.String({ description: "Sequential step agent name" })),
+  task: Type.Optional(Type.String({
+    description: "Task template with variables: {task}=original request, {previous}=prior step's text response, {chain_dir}=shared folder, {outputs.name}=prior named output. Required for first step, defaults to '{previous}' for subsequent steps."
+  })),
+  phase: Type.Optional(Type.String({ description: "Optional phase/group label for status and graph rendering." })),
+  label: Type.Optional(Type.String({ description: "Optional user-facing label for this chain step." })),
+  as: Type.Optional(Type.String({ description: "Optional safe identifier used as {outputs.name} in later chain steps." })),
+  outputSchema: Type.Optional(JsonSchemaObject),
+  cwd: Type.Optional(Type.String()),
+  output: Type.Optional(OutputOverride),
+  outputMode: Type.Optional(OutputModeOverride),
+  reads: Type.Optional(ReadsOverride),
+  progress: Type.Optional(Type.Boolean({ description: "Enable progress.md tracking in {chain_dir}" })),
+  skill: Type.Optional(SkillOverride),
+  model: Type.Optional(Type.String({ description: "Override model for this step" })),
+  toolBudget: Type.Optional(ToolBudgetOverride),
+  acceptance: Type.Optional(AcceptanceOverride),
+  parallel: Type.Optional(Type.Unsafe({
+    anyOf: [
+      Type.Array(ParallelTaskSchema, { minItems: 1, description: "Tasks to run in parallel" }),
+      DynamicParallelTemplateSchema
+    ],
+    description: "Static parallel tasks array, or a single dynamic fanout child template when expand/collect are present."
+  })),
+  expand: Type.Optional(DynamicExpandSchema),
+  collect: Type.Optional(DynamicCollectSchema),
+  concurrency: Type.Optional(Type.Number({ description: "Max concurrent tasks (default: 4)" })),
+  failFast: Type.Optional(Type.Boolean({ description: "Stop on first failure (default: false)" })),
+  worktree: Type.Optional(Type.Boolean({
+    description: "Create isolated git worktrees for each parallel task."
+  }))
+}, {
+  description: "Chain step: use {agent, task?, ...} for sequential, {parallel: [...]} for static concurrent execution, or {expand, parallel: {...}, collect} for dynamic fanout.",
+  additionalProperties: false
+});
+const ControlOverrides = Type.Object({
+  enabled: Type.Optional(Type.Boolean({ description: "Enable/disable subagent control attention tracking for this run" })),
+  needsAttentionAfterMs: Type.Optional(Type.Integer({ minimum: 1, description: "No-observed-activity window before a run needs attention" })),
+  activeNoticeAfterMs: Type.Optional(Type.Integer({ minimum: 1, description: "Active-long-running notice threshold by elapsed ms (default: 240000)" })),
+  activeNoticeAfterTurns: Type.Optional(Type.Integer({ minimum: 1, description: "Optional active-long-running notice threshold by assistant turns (disabled by default)" })),
+  activeNoticeAfterTokens: Type.Optional(Type.Integer({ minimum: 1, description: "Optional active-long-running notice threshold by total tokens (disabled by default)" })),
+  failedToolAttemptsBeforeAttention: Type.Optional(Type.Integer({ minimum: 1, description: "Consecutive mutating-tool failures before escalating to needs_attention (default: 3)" })),
+  notifyOn: Type.Optional(Type.Array(Type.String({ enum: ["active_long_running", "needs_attention"] }), {
+    description: "Control event types that should notify the parent/orchestrator. Defaults to active_long_running and needs_attention."
+  })),
+  notifyChannels: Type.Optional(Type.Array(Type.String({ enum: ["event", "async", "intercom"] }), {
+    description: "Notification channels to use when available. Defaults to event, async, and intercom."
+  }))
+});
+const SubagentParamsSchema = Type.Object({
+  agent: Type.Optional(Type.String({ description: "Agent name (SINGLE mode) or target for management get/update/delete" })),
+  task: Type.Optional(Type.String({ description: "Task (SINGLE mode, optional for self-contained agents)" })),
+  action: Type.Optional(Type.String({
+    description: "Management/control action only. Must be omitted for execution mode (single, parallel, or chain)."
+  })),
+  id: Type.Optional(Type.String({
+    description: "Run id or prefix for action='status', action='interrupt', action='resume', action='steer', or action='append-step'."
+  })),
+  runId: Type.Optional(Type.String({
+    description: "Target run ID for action='interrupt', action='resume', action='steer', or action='append-step'. Defaults to the most recently active controllable run for interrupt. Prefer id for new calls."
+  })),
+  dir: Type.Optional(Type.String({
+    description: "Async run directory for action='status', action='resume', or action='steer'."
+  })),
+  index: Type.Optional(Type.Integer({ minimum: 0, description: "Zero-based child index for actions that target a specific child or transcript." })),
+  view: Type.Optional(Type.String({
+    enum: ["fleet", "transcript"],
+    description: "Optional status view. Use view='fleet' for a read-only active foreground/async fleet surface, or view='transcript' with id/dir (and optional index) to tail a run transcript."
+  })),
+  lines: Type.Optional(Type.Integer({ minimum: 1, maximum: 500, description: "Maximum transcript lines for action='status', view='transcript'. Defaults to 80." })),
+  message: Type.Optional(Type.String({ description: "Follow-up message for action='resume' or non-terminal guidance for action='steer'. Use index to choose a child from multi-child runs." })),
+  schedule: Type.Optional(Type.String({ description: "Explicit one-shot schedule for action='schedule'. Only honored when scheduledRuns.enabled is true. Use '+10m' or a future ISO timestamp with timezone; scheduled runs always launch async with fresh context." })),
+  scheduleName: Type.Optional(Type.String({ description: "Optional display name for action='schedule'." })),
+  chainName: Type.Optional(Type.String({
+    description: "Chain name for get/update/delete management actions"
+  })),
+  config: Type.Optional(Type.Unsafe({
+    anyOf: [
+      { type: "object", additionalProperties: true },
+      { type: "string" }
+    ],
+    description: "Agent/chain config for create/update. Object or JSON string; presence of steps creates a chain."
+  })),
+  tasks: Type.Optional(Type.Array(TaskItem, { description: "PARALLEL mode: [{agent, task, count?, output?, outputMode?, reads?, progress?}, ...]" })),
+  concurrency: Type.Optional(Type.Integer({ minimum: 1, description: "Top-level PARALLEL mode only: max concurrent tasks. Defaults to config.parallel.concurrency or 4." })),
+  worktree: Type.Optional(Type.Boolean({
+    description: "Create isolated git worktrees for parallel tasks; requires clean git state."
+  })),
+  chain: Type.Optional(Type.Array(ChainItem, { description: "CHAIN mode: sequential steps; each result becomes {previous}. append-step takes one tail step and may use {chain_dir}/{outputs.name}." })),
+  context: Type.Optional(Type.String({
+    enum: ["fresh", "fork"],
+    description: "'fresh' or 'fork' to branch from parent session. Explicit context overrides every child in the invocation. If omitted, each requested agent uses its own defaultContext; agents without defaultContext: 'fork' run fresh."
+  })),
+  chainDir: Type.Optional(Type.String({ description: "Persistent chain artifact directory; defaults to user-scoped temp storage." })),
+  async: Type.Optional(Type.Boolean({ description: "Run in background (default: false, or per config)" })),
+  timeoutMs: Type.Optional(Type.Integer({ minimum: 1, description: "Optional run-level timeout in ms for foreground and async/background runs. Alias of maxRuntimeMs." })),
+  maxRuntimeMs: Type.Optional(Type.Integer({ minimum: 1, description: "Alias of timeoutMs for optional run-level timeout in foreground and async/background runs." })),
+  turnBudget: Type.Optional(TurnBudgetOverride),
+  toolBudget: Type.Optional(ToolBudgetOverride),
+  agentScope: Type.Optional(Type.String({ description: "Agent discovery scope: 'user', 'project', or 'both' (default: 'both'; project wins on name collisions)" })),
+  cwd: Type.Optional(Type.String()),
+  artifacts: Type.Optional(Type.Boolean({ description: "Write debug artifacts (default: true)" })),
+  includeProgress: Type.Optional(Type.Boolean({ description: "Include full progress in result (default: false)" })),
+  share: Type.Optional(Type.Boolean({ description: "Upload session to GitHub Gist for sharing (default: false)" })),
+  sessionDir: Type.Optional(Type.String({ description: "Directory to store session logs (default: temp; enables sessions even if share=false)" })),
+  clarify: Type.Optional(Type.Boolean({ description: "Show TUI to preview/edit before execution. Explicit clarify: true keeps the run foreground for the clarify UI; omitted clarify can still run in the background when async: true is set." })),
+  control: Type.Optional(ControlOverrides),
+  output: Type.Optional(Type.Unsafe({
+    anyOf: [
+      { type: "string" },
+      { type: "boolean" }
+    ],
+    description: "Output file for single agent (string), or false to disable. Relative paths resolve against cwd."
+  })),
+  outputMode: Type.Optional(OutputModeOverride),
+  skill: Type.Optional(SkillOverride),
+  model: Type.Optional(Type.String({ description: "Override model for single agent (e.g. 'anthropic/claude-sonnet-4')" })),
+  acceptance: Type.Optional(AcceptanceOverride)
+});
+export const SubagentParams = keepTopLevelParameterDescriptions(SubagentParamsSchema);
+const WaitParamsSchema = Type.Object({
+  id: Type.Optional(Type.String({
+    description: "Run id or prefix to wait for one specific run. Omit to wait across every active async run started in this session."
+  })),
+  all: Type.Optional(Type.Boolean({
+    description: "Wait for ALL active runs to finish. Default false: return as soon as the first run finishes, so a fleet manager can spawn a replacement and wait again. Ignored when id targets a single run."
+  })),
+  timeoutMs: Type.Optional(Type.Integer({
+    minimum: 1,
+    description: "Give up waiting after this many milliseconds (the runs keep going regardless). Defaults to 1800000 (30 minutes)."
+  }))
+});
+export const WaitParams = keepTopLevelParameterDescriptions(WaitParamsSchema);

package/extensions/dm-subagents/src/extension/tool-description.js

@@ -1,10 +1,16 @@
-import*as A from"node:fs";import*as _ from"node:path";import*as W from"node:fs";import*as U from"node:os";import*as q from"node:path";import*as V from"node:os";import*as K from"node:path";function L(Q){return Q.trim().replace(/[^A-Za-z0-9._-]+/g,"-").replace(/^-+|-+$/g,"")||"unknown"}function w(Q){let Z=Q?.env??process.env,J=Q&&Object.hasOwn(Q,"getuid")?Q.getuid:process.getuid?.bind(process);if(typeof J==="function")return`uid-${J()}`;for(let Y of["USERNAME","USER","LOGNAME"]){let G=Z[Y];if(G)return`user-${L(G)}`}let $=Q&&Object.hasOwn(Q,"userInfo")?Q.userInfo:V.userInfo;try{let Y=$?.().username;if(Y)return`user-${L(Y)}`}catch{}let X=Z.USERPROFILE??Z.HOME;if(X)return`home-${L(X)}`;let R=Q&&Object.hasOwn(Q,"homedir")?Q.homedir:V.homedir;try{let Y=R?.();if(Y)return`home-${L(Y)}`}catch{}return"shared"}var M=K.join(V.tmpdir(),`dm-subagents-${w()}`),p=K.join(M,"async-subagent-results"),n=K.join(M,"async-subagent-runs"),x=K.join(M,"chain-runs"),o=K.join(M,"artifacts");var y=".dm",S="@duckmind/dm-coding-agent",D="DM_SUBAGENTS_PI_CODING_AGENT_PACKAGE_ROOT";function I(Q){return typeof Q==="string"&&Q.trim()?Q:void 0}function T(Q){if(!Q)return;try{let Z=JSON.parse(W.readFileSync(q.join(Q,"package.json"),"utf-8"));if(Z.name!==S)return;return I(Z.piConfig?.configDir)}catch{return}}function v(Q=process.argv[1],Z=process.env[D]){let J=T(Z);if(J)return J;if(!Q)return;try{let $=q.dirname(W.realpathSync(Q));while($!==q.dirname($)){let X=T($);if(X)return X;$=q.dirname($)}}catch{}return}function P(Q,Z,J){return(Q&&typeof Q==="object"?I(Q.CONFIG_DIR_NAME):void 0)??v(Z,J)??y}function C(){return P()}function H(Q){return q.join(Q,C())}function z(){let Q=process.env.DM_CODING_AGENT_DIR;if(Q==="~")return U.homedir();if(Q?.startsWith("~/"))return q.join(U.homedir(),Q.slice(2));return Q||q.join(U.homedir(),C(),"agent")}var F="subagent-tool-description.md",b=51200,j=`SAFETY-CRITICAL SUBAGENT GUIDANCE:
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { getAgentDir, getProjectConfigDir } from "../shared/utils.js";
+const CUSTOM_TOOL_DESCRIPTION_FILE = "subagent-tool-description.md";
+const CUSTOM_TOOL_DESCRIPTION_MAX_BYTES = 50 * 1024;
+export const SUBAGENT_SAFETY_GUIDANCE = `SAFETY-CRITICAL SUBAGENT GUIDANCE:
 • Use { action: "list" } before execution and only run executable/non-disabled agents or chains.
 • Keep execution and management separate: omit action for SINGLE/PARALLEL/CHAIN execution; use action only for list/get/models/create/update/delete/status/interrupt/resume/append-step/doctor.
 • Async/background runs: launch with async:true only when work can proceed independently. Do not sleep or poll status just to wait; if this turn must block, use the wait tool. Otherwise continue useful work or respond and let completion notifications arrive.
 • Child-safety boundary: ordinary child subagents are not orchestrators and must not run subagents. Only explicitly configured fanout children may use the child-safe subagent tool, still bounded by depth/session limits.
 • Writing/review safety: keep one writer for the same cwd/worktree. Use fresh-context read-only reviewers/validators for independent review, then have the parent synthesize and apply fixes as the sole writer unless an isolated worktree was intentionally requested.
-• Artifacts/status essentials: chain outputs live under {chain_dir}; async runs expose asyncId/asyncDir with status.json, events.jsonl, output logs, and status via { action: "status", id }. Include output paths and residual risks when reporting results.`,E=`Delegate to subagents or manage agent definitions.
+• Artifacts/status essentials: chain outputs live under {chain_dir}; async runs expose asyncId/asyncDir with status.json, events.jsonl, output logs, and status via { action: "status", id }. Include output paths and residual risks when reporting results.`;
+export const FULL_SUBAGENT_TOOL_DESCRIPTION = `Delegate to subagents or manage agent definitions.
 
 EXECUTION (use exactly ONE mode):
 • Before executing, use { action: "list" } to inspect configured agents/chains. Only execute agents listed as executable/non-disabled.
@@ -53,7 +59,8 @@ SCHEDULE (opt-in; requires { "scheduledRuns": { "enabled": true } } in config.js
 DIAGNOSTICS:
 • { action: "doctor" } - read-only report for runtime paths, discovery, sessions, and intercom
 
-${j}`,O=`Delegate to subagents or manage definitions. Use exactly one mode per call.
+${SUBAGENT_SAFETY_GUIDANCE}`;
+export const COMPACT_SUBAGENT_TOOL_DESCRIPTION = `Delegate to subagents or manage definitions. Use exactly one mode per call.
 
 EXECUTE:
 • Before execution, call { action: "list" }; run only executable/non-disabled configured agents/chains.
@@ -73,8 +80,106 @@ ASYNC / WAIT:
 
 SAFETY:
 • Ordinary child subagents are not orchestrators and must not run subagents. Only explicit fanout children may use child-safe subagent, still bounded by depth/session limits.
-• Keep one writer per cwd/worktree. Use fresh read-only review/validation fanout, then synthesize and apply fixes from the parent unless isolated worktrees were intentionally requested.`;function f(Q){return Q==="full"||Q==="compact"||Q==="custom"}function B(Q,Z){(Q?.warn??console.warn)(`[dm-subagents] ${Z}`)}function k(Q,Z){let J=Q.toolDescriptionMode;if(J===void 0)return"full";if(f(J))return J;return B(Z,`Ignoring invalid toolDescriptionMode ${JSON.stringify(J)}; expected "full", "compact", or "custom".`),"full"}function m(Q){let Z=Q?.cwd??process.cwd(),J=Q?.agentDir??z();return[_.join(H(Z),F),_.join(J,F)]}function h(Q,Z){let J=Z?.cwd??process.cwd(),$=Z?.agentDir??z(),X=H(J),R={fullDescription:()=>E,full:()=>E,compactDescription:()=>O,compact:()=>O,safetyGuidance:()=>j,safety:()=>j,agentDir:()=>$,projectConfigDir:()=>X};return Q.replace(/\{\{(\w+)\}\}/g,(Y,G)=>{let N=R[G];if(N)return N();return B(Z,`${F}: unknown placeholder ${Y} left unchanged.`),Y})}function c(Q){for(let Z of m(Q)){let J;try{J=A.statSync(Z)}catch($){if(typeof $==="object"&&$!==null&&"code"in $&&$.code==="ENOENT")continue;B(Q,`Failed to inspect custom tool description '${Z}': ${$ instanceof Error?$.message:String($)}`);continue}if(!J.isFile()){B(Q,`Ignoring custom tool description '${Z}' because it is not a file.`);continue}if(J.size>b){B(Q,`Ignoring custom tool description '${Z}' because it is larger than ${b} bytes.`);continue}try{let $=A.readFileSync(Z,"utf-8").trim();if(!$){B(Q,`Ignoring empty custom tool description '${Z}'.`);continue}let X=h($,Q).trim();if(!X){B(Q,`Ignoring custom tool description '${Z}' because it rendered empty.`);continue}return X}catch($){B(Q,`Failed to read custom tool description '${Z}': ${$ instanceof Error?$.message:String($)}`)}}return}function u(Q){let Z=Q.split(j).map((J)=>J.trim()).filter(Boolean).join(`
+• Keep one writer per cwd/worktree. Use fresh read-only review/validation fanout, then synthesize and apply fixes from the parent unless isolated worktrees were intentionally requested.`;
+function isToolDescriptionMode(value) {
+  return value === "full" || value === "compact" || value === "custom";
+}
+function warn(options, message) {
+  (options?.warn ?? console.warn)(`[dm-subagents] ${message}`);
+}
+export function resolveToolDescriptionMode(config, options) {
+  const mode = config.toolDescriptionMode;
+  if (mode === undefined)
+    return "full";
+  if (isToolDescriptionMode(mode))
+    return mode;
+  warn(options, `Ignoring invalid toolDescriptionMode ${JSON.stringify(mode)}; expected "full", "compact", or "custom".`);
+  return "full";
+}
+function customDescriptionPaths(options) {
+  const cwd = options?.cwd ?? process.cwd();
+  const agentDir = options?.agentDir ?? getAgentDir();
+  return [
+    path.join(getProjectConfigDir(cwd), CUSTOM_TOOL_DESCRIPTION_FILE),
+    path.join(agentDir, CUSTOM_TOOL_DESCRIPTION_FILE)
+  ];
+}
+function renderCustomTemplate(template, options) {
+  const cwd = options?.cwd ?? process.cwd();
+  const agentDir = options?.agentDir ?? getAgentDir();
+  const projectConfigDir = getProjectConfigDir(cwd);
+  const variables = {
+    fullDescription: () => FULL_SUBAGENT_TOOL_DESCRIPTION,
+    full: () => FULL_SUBAGENT_TOOL_DESCRIPTION,
+    compactDescription: () => COMPACT_SUBAGENT_TOOL_DESCRIPTION,
+    compact: () => COMPACT_SUBAGENT_TOOL_DESCRIPTION,
+    safetyGuidance: () => SUBAGENT_SAFETY_GUIDANCE,
+    safety: () => SUBAGENT_SAFETY_GUIDANCE,
+    agentDir: () => agentDir,
+    projectConfigDir: () => projectConfigDir
+  };
+  return template.replace(/\{\{(\w+)\}\}/g, (raw, name) => {
+    const replacement = variables[name];
+    if (replacement)
+      return replacement();
+    warn(options, `${CUSTOM_TOOL_DESCRIPTION_FILE}: unknown placeholder ${raw} left unchanged.`);
+    return raw;
+  });
+}
+function loadCustomToolDescription(options) {
+  for (const filePath of customDescriptionPaths(options)) {
+    let stat;
+    try {
+      stat = fs.statSync(filePath);
+    } catch (error) {
+      if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT")
+        continue;
+      warn(options, `Failed to inspect custom tool description '${filePath}': ${error instanceof Error ? error.message : String(error)}`);
+      continue;
+    }
+    if (!stat.isFile()) {
+      warn(options, `Ignoring custom tool description '${filePath}' because it is not a file.`);
+      continue;
+    }
+    if (stat.size > CUSTOM_TOOL_DESCRIPTION_MAX_BYTES) {
+      warn(options, `Ignoring custom tool description '${filePath}' because it is larger than ${CUSTOM_TOOL_DESCRIPTION_MAX_BYTES} bytes.`);
+      continue;
+    }
+    try {
+      const template = fs.readFileSync(filePath, "utf-8").trim();
+      if (!template) {
+        warn(options, `Ignoring empty custom tool description '${filePath}'.`);
+        continue;
+      }
+      const rendered = renderCustomTemplate(template, options).trim();
+      if (!rendered) {
+        warn(options, `Ignoring custom tool description '${filePath}' because it rendered empty.`);
+        continue;
+      }
+      return rendered;
+    } catch (error) {
+      warn(options, `Failed to read custom tool description '${filePath}': ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
+  return;
+}
+function withMandatorySafetyGuidance(description) {
+  const customDescription = description.split(SUBAGENT_SAFETY_GUIDANCE).map((part) => part.trim()).filter(Boolean).join(`
 
-`);return Z?`${Z}
+`);
+  return customDescription ? `${customDescription}
 
-${j}`:j}function zQ(Q={},Z){let J=k(Q,Z);if(J==="compact")return O;if(J==="custom"){let $=c(Z);if($)return u($);B(Z,`${F} was not found or valid for toolDescriptionMode "custom"; using full description.`)}return E}export{k as resolveToolDescriptionMode,zQ as buildSubagentToolDescription,j as SUBAGENT_SAFETY_GUIDANCE,E as FULL_SUBAGENT_TOOL_DESCRIPTION,O as COMPACT_SUBAGENT_TOOL_DESCRIPTION};
+${SUBAGENT_SAFETY_GUIDANCE}` : SUBAGENT_SAFETY_GUIDANCE;
+}
+export function buildSubagentToolDescription(config = {}, options) {
+  const mode = resolveToolDescriptionMode(config, options);
+  if (mode === "compact")
+    return COMPACT_SUBAGENT_TOOL_DESCRIPTION;
+  if (mode === "custom") {
+    const custom = loadCustomToolDescription(options);
+    if (custom)
+      return withMandatorySafetyGuidance(custom);
+    warn(options, `${CUSTOM_TOOL_DESCRIPTION_FILE} was not found or valid for toolDescriptionMode "custom"; using full description.`);
+  }
+  return FULL_SUBAGENT_TOOL_DESCRIPTION;
+}

package/extensions/dm-subagents/src/intercom/intercom-bridge.js

@@ -1,4 +1,17 @@
-import*as R from"node:fs";import*as T from"node:os";import*as B from"node:path";import*as X from"node:fs";import*as G from"node:os";import*as U from"node:path";import*as V from"node:os";import*as K from"node:path";function H(Q){return Q.trim().replace(/[^A-Za-z0-9._-]+/g,"-").replace(/^-+|-+$/g,"")||"unknown"}function b(Q){let Z=Q?.env??process.env,Y=Q&&Object.hasOwn(Q,"getuid")?Q.getuid:process.getuid?.bind(process);if(typeof Y==="function")return`uid-${Y()}`;for(let q of["USERNAME","USER","LOGNAME"]){let j=Z[q];if(j)return`user-${H(j)}`}let $=Q&&Object.hasOwn(Q,"userInfo")?Q.userInfo:V.userInfo;try{let q=$?.().username;if(q)return`user-${H(q)}`}catch{}let J=Z.USERPROFILE??Z.HOME;if(J)return`home-${H(J)}`;let W=Q&&Object.hasOwn(Q,"homedir")?Q.homedir:V.homedir;try{let q=W?.();if(q)return`home-${H(q)}`}catch{}return"shared"}var z=K.join(V.tmpdir(),`dm-subagents-${b()}`),n=K.join(z,"async-subagent-results"),o=K.join(z,"async-subagent-runs"),S=K.join(z,"chain-runs"),l=K.join(z,"artifacts");var y=".dm",x="@duckmind/dm-coding-agent",D="DM_SUBAGENTS_PI_CODING_AGENT_PACKAGE_ROOT";function O(Q){return typeof Q==="string"&&Q.trim()?Q:void 0}function _(Q){if(!Q)return;try{let Z=JSON.parse(X.readFileSync(U.join(Q,"package.json"),"utf-8"));if(Z.name!==x)return;return O(Z.piConfig?.configDir)}catch{return}}function P(Q=process.argv[1],Z=process.env[D]){let Y=_(Z);if(Y)return Y;if(!Q)return;try{let $=U.dirname(X.realpathSync(Q));while($!==U.dirname($)){let J=_($);if(J)return J;$=U.dirname($)}}catch{}return}function v(Q,Z,Y){return(Q&&typeof Q==="object"?O(Q.CONFIG_DIR_NAME):void 0)??P(Z,Y)??y}function f(){return v()}function L(){let Q=process.env.DM_CODING_AGENT_DIR;if(Q==="~")return G.homedir();if(Q?.startsWith("~/"))return U.join(G.homedir(),Q.slice(2));return Q||U.join(G.homedir(),f(),"agent")}var F="native:dm-subagents-supervisor-channel";function C(){return L()}function k(Q=C()){return B.join(Q,"extensions","subagent")}var h="subagent-chat",A="Intercom orchestration channel:",M=`The inherited thread is reference-only. Do not continue that conversation or send questions, status updates, or completion handoffs to the supervisor in normal assistant text.
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { getAgentDir } from "../shared/utils.js";
+export const NATIVE_INTERCOM_EXTENSION_DIR = "native:dm-subagents-supervisor-channel";
+function defaultAgentDir() {
+  return getAgentDir();
+}
+function defaultSubagentConfigDir(agentDir = defaultAgentDir()) {
+  return path.join(agentDir, "extensions", "subagent");
+}
+const DEFAULT_INTERCOM_TARGET_PREFIX = "subagent-chat";
+export const INTERCOM_BRIDGE_MARKER = "Intercom orchestration channel:";
+const DEFAULT_INTERCOM_BRIDGE_TEMPLATE = `The inherited thread is reference-only. Do not continue that conversation or send questions, status updates, or completion handoffs to the supervisor in normal assistant text.
 
 Use contact_supervisor first. It resolves the supervisor session "{orchestratorTarget}" and run metadata automatically.
 - Need a decision, blocked, approval, or product/API/scope ambiguity: contact_supervisor({ reason: "need_decision", message: "<question>" })
@@ -7,7 +20,116 @@ Use contact_supervisor first. It resolves the supervisor session "{orchestratorT
 - Meaningful progress or unexpected discoveries that change the plan: contact_supervisor({ reason: "progress_update", message: "UPDATE: <summary>" })
 - Generic intercom is lower-level plumbing/fallback only: intercom({ action: "ask", to: "{orchestratorTarget}", message: "<question>" })
 
-Do not use contact_supervisor or intercom for routine completion handoffs. If no coordination is needed, return a focused task result.`;function LQ(Q,Z){let Y=Q?.trim();if(Y)return Y;let $=Z.startsWith("session-")?Z.slice(8):Z;return`${h}-${$.slice(0,8)}`}function E(Q){return Q.trim().toLowerCase().replace(/[^a-z0-9_-]+/g,"-").replace(/^-+|-+$/g,"")||"agent"}function FQ(Q,Z,Y){let $=Y!==void 0?`-${Y+1}`:"";return`subagent-${E(Z)}-${E(Q)}${$}`}function m(Q){if(Q==="off"||Q==="always"||Q==="fork-only")return Q;return"always"}function w(Q){if(!Q||typeof Q!=="object"||Array.isArray(Q))return{mode:"always",instructionFile:""};return{mode:m(Q.mode),instructionFile:typeof Q.instructionFile==="string"?Q.instructionFile:""}}function c(Q){return Q.startsWith("~/")?B.join(T.homedir(),Q.slice(2)):Q}function g(Q,Z){if(!Q)return M;let Y=c(Q),$=B.isAbsolute(Y)?Y:B.resolve(Z,Y);try{return R.readFileSync($,"utf-8")}catch(J){return console.warn(`Failed to read intercom bridge instructionFile at '${$}'. Using default instructions.`,J),M}}function N(Q,Z){let Y=Z.replaceAll("{orchestratorTarget}",Q).trim();if(Y.startsWith(A))return Y;return`${A}
-${Y}`}function I(Q,Z,Y){if(Q==="off")return"bridge mode is off";if(Q==="fork-only"&&Z!=="fork")return"bridge mode is fork-only and context is not fork";if(!Y)return"orchestrator target is not available";return}function AQ(Q){let Y=w(Q.config).mode,$=Q.orchestratorTarget?.trim(),J=Y!=="off"&&!(Y==="fork-only"&&Q.context!=="fork"),W=I(Y,Q.context,$);return{active:W===void 0,mode:Y,wantsIntercom:J,supervisorChannelAvailable:!0,extensionDir:F,...$?{orchestratorTarget:$}:{},...W?{reason:W}:{}}}function MQ(Q){let Z=w(Q.config),Y=Z.mode,$=Q.orchestratorTarget?.trim(),J=B.resolve(Q.agentDir??C()),W=B.resolve(Q.settingsDir??k(J)),q=N($||"{orchestratorTarget}",M);if(I(Y,Q.context,$)||!$)return{active:!1,mode:Y,extensionDir:F,instruction:q};return{active:!0,mode:Y,orchestratorTarget:$,extensionDir:F,instruction:N($,g(Z.instructionFile,W))}}function _Q(Q,Z){if(!Z.active||!Z.orchestratorTarget)return Q;let Y=["intercom","contact_supervisor"],$=Q.tools?[...Q.tools,...Y.filter((j)=>!Q.tools?.includes(j))]:Q.tools,J=Z.instruction,W=Q.systemPrompt?.trim()||"",q=W.includes(A)?W:W?`${W}
+Do not use contact_supervisor or intercom for routine completion handoffs. If no coordination is needed, return a focused task result.`;
+export function resolveIntercomSessionTarget(sessionName, sessionId) {
+  const trimmedName = sessionName?.trim();
+  if (trimmedName)
+    return trimmedName;
+  const normalizedSessionId = sessionId.startsWith("session-") ? sessionId.slice("session-".length) : sessionId;
+  return `${DEFAULT_INTERCOM_TARGET_PREFIX}-${normalizedSessionId.slice(0, 8)}`;
+}
+function sanitizeIntercomTargetPart(value) {
+  return value.trim().toLowerCase().replace(/[^a-z0-9_-]+/g, "-").replace(/^-+|-+$/g, "") || "agent";
+}
+export function resolveSubagentIntercomTarget(runId, agent, index) {
+  const stepSuffix = index !== undefined ? `-${index + 1}` : "";
+  return `subagent-${sanitizeIntercomTargetPart(agent)}-${sanitizeIntercomTargetPart(runId)}${stepSuffix}`;
+}
+export function resolveIntercomBridgeMode(value) {
+  if (value === "off" || value === "always" || value === "fork-only")
+    return value;
+  return "always";
+}
+function resolveIntercomBridgeConfig(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return { mode: "always", instructionFile: "" };
+  }
+  return {
+    mode: resolveIntercomBridgeMode(value.mode),
+    instructionFile: typeof value.instructionFile === "string" ? value.instructionFile : ""
+  };
+}
+function expandTilde(filePath) {
+  return filePath.startsWith("~/") ? path.join(os.homedir(), filePath.slice(2)) : filePath;
+}
+function resolveInstructionTemplate(instructionFile, settingsDir) {
+  if (!instructionFile)
+    return DEFAULT_INTERCOM_BRIDGE_TEMPLATE;
+  const expandedPath = expandTilde(instructionFile);
+  const resolvedPath = path.isAbsolute(expandedPath) ? expandedPath : path.resolve(settingsDir, expandedPath);
+  try {
+    return fs.readFileSync(resolvedPath, "utf-8");
+  } catch (error) {
+    console.warn(`Failed to read intercom bridge instructionFile at '${resolvedPath}'. Using default instructions.`, error);
+    return DEFAULT_INTERCOM_BRIDGE_TEMPLATE;
+  }
+}
+function buildIntercomBridgeInstruction(orchestratorTarget, template) {
+  const instruction = template.replaceAll("{orchestratorTarget}", orchestratorTarget).trim();
+  if (instruction.startsWith(INTERCOM_BRIDGE_MARKER))
+    return instruction;
+  return `${INTERCOM_BRIDGE_MARKER}
+${instruction}`;
+}
+function inactiveReason(mode, context, orchestratorTarget) {
+  if (mode === "off")
+    return "bridge mode is off";
+  if (mode === "fork-only" && context !== "fork")
+    return "bridge mode is fork-only and context is not fork";
+  if (!orchestratorTarget)
+    return "orchestrator target is not available";
+  return;
+}
+export function diagnoseIntercomBridge(input) {
+  const config = resolveIntercomBridgeConfig(input.config);
+  const mode = config.mode;
+  const orchestratorTarget = input.orchestratorTarget?.trim();
+  const wantsIntercom = mode !== "off" && !(mode === "fork-only" && input.context !== "fork");
+  const reason = inactiveReason(mode, input.context, orchestratorTarget);
+  return {
+    active: reason === undefined,
+    mode,
+    wantsIntercom,
+    supervisorChannelAvailable: true,
+    extensionDir: NATIVE_INTERCOM_EXTENSION_DIR,
+    ...orchestratorTarget ? { orchestratorTarget } : {},
+    ...reason ? { reason } : {}
+  };
+}
+export function resolveIntercomBridge(input) {
+  const config = resolveIntercomBridgeConfig(input.config);
+  const mode = config.mode;
+  const orchestratorTarget = input.orchestratorTarget?.trim();
+  const agentDir = path.resolve(input.agentDir ?? defaultAgentDir());
+  const settingsDir = path.resolve(input.settingsDir ?? defaultSubagentConfigDir(agentDir));
+  const defaultInstruction = buildIntercomBridgeInstruction(orchestratorTarget || "{orchestratorTarget}", DEFAULT_INTERCOM_BRIDGE_TEMPLATE);
+  const reason = inactiveReason(mode, input.context, orchestratorTarget);
+  if (reason || !orchestratorTarget) {
+    return { active: false, mode, extensionDir: NATIVE_INTERCOM_EXTENSION_DIR, instruction: defaultInstruction };
+  }
+  return {
+    active: true,
+    mode,
+    orchestratorTarget,
+    extensionDir: NATIVE_INTERCOM_EXTENSION_DIR,
+    instruction: buildIntercomBridgeInstruction(orchestratorTarget, resolveInstructionTemplate(config.instructionFile, settingsDir))
+  };
+}
+export function applyIntercomBridgeToAgent(agent, bridge) {
+  if (!bridge.active || !bridge.orchestratorTarget)
+    return agent;
+  const bridgeTools = ["intercom", "contact_supervisor"];
+  const tools = agent.tools ? [...agent.tools, ...bridgeTools.filter((tool) => !agent.tools?.includes(tool))] : agent.tools;
+  const instruction = bridge.instruction;
+  const trimmedPrompt = agent.systemPrompt?.trim() || "";
+  const systemPrompt = trimmedPrompt.includes(INTERCOM_BRIDGE_MARKER) ? trimmedPrompt : trimmedPrompt ? `${trimmedPrompt}
 
-${J}`:J;if($===Q.tools&&q===Q.systemPrompt)return Q;return{...Q,tools:$,systemPrompt:q}}export{FQ as resolveSubagentIntercomTarget,LQ as resolveIntercomSessionTarget,m as resolveIntercomBridgeMode,MQ as resolveIntercomBridge,AQ as diagnoseIntercomBridge,_Q as applyIntercomBridgeToAgent,F as NATIVE_INTERCOM_EXTENSION_DIR,A as INTERCOM_BRIDGE_MARKER};
+${instruction}` : instruction;
+  if (tools === agent.tools && systemPrompt === agent.systemPrompt)
+    return agent;
+  return {
+    ...agent,
+    tools,
+    systemPrompt
+  };
+}