dsh-pstack 0.1.0 → 0.2.0-beta.1

package/dist/subagent.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"subagent.mjs","names":[],"sources":["../src/roles.ts","../src/models.ts","../src/subagent.ts"],"sourcesContent":["/**\n * pstack role resolution.\n *\n * `~/.dsh/pstack-models.md` holds one role per line. The tool resolves a role\n * into a child LLM route at call time, so edits apply to the next delegation\n * without restarting the harness.\n *\n * Parsing never throws. A typo in one line must not break delegation, but it\n * must also not disappear: `parseModelConfigWithIssues` collects `issues` and\n * the parser keeps them so a caller can report the line that is wrong.\n */\n\nexport interface Route {\n  readonly provider: string;\n  readonly model: string;\n  readonly reasoningEffort?: string;\n}\n\nexport type RoleValue = \"inherit-parent\" | Route;\nexport type RoleTable = ReadonlyMap<string, readonly RoleValue[]>;\n\n/** A problem in the role file, tied to the line that caused it. */\nexport interface RoleIssue {\n  /** 1-based line number in `pstack-models.md`. */\n  readonly line: number;\n  readonly message: string;\n}\n\nexport interface ParsedModelConfig {\n  readonly table: RoleTable;\n  readonly issues: readonly RoleIssue[];\n}\n\nconst INHERIT = new Set([\"inherit-parent\", \"auto\", \"parent\"]);\n\n/**\n * Reasoning efforts DSH understands, widest first. A token outside this set is\n * reported rather than dropped: a route that silently loses `xhigh` looks\n * configured and is not.\n */\nexport const REASONING_EFFORTS = [\"max\", \"xhigh\", \"high\", \"medium\", \"low\", \"off\"] as const;\nconst EFFORTS = new Set<string>(REASONING_EFFORTS);\n\n/**\n * Register the role names on one line.\n *\n * The whole left side is always stored as one key, so\n * `reflect judgment, divergent, synthesizer` stays addressable as written.\n * When the comma list is a genuine group (`feature, refactoring`), each part is\n * stored too, so a caller can name just one of them. Both spellings therefore\n * work, and neither can shadow the other: the full key is a different string.\n */\nfunction splitRoles(left: string): string[] {\n  const whole = left.trim().toLowerCase().replace(/\\s+/g, \" \");\n  if (!whole) return [];\n  const parts = left\n    .split(\",\")\n    .map((part) => part.trim().toLowerCase())\n    .filter(Boolean);\n  return parts.length > 1 ? [whole, ...parts] : [whole];\n}\n\nexport function parseModelConfigWithIssues(source: string): ParsedModelConfig {\n  const table = new Map<string, RoleValue[]>();\n  const issues: RoleIssue[] = [];\n  const lines = source.replace(/\\r\\n/g, \"\\n\").split(\"\\n\");\n\n  for (const [index, rawLine] of lines.entries()) {\n    const line = rawLine.trim();\n    if (!line || line.startsWith(\"#\") || line.startsWith(\"//\")) continue;\n    const lineNumber = index + 1;\n    const separator = line.indexOf(\":\");\n    if (separator === -1) {\n      issues.push({\n        line: lineNumber,\n        message: `expected \"role: value\", got ${JSON.stringify(line)}`,\n      });\n      continue;\n    }\n    const roles = splitRoles(line.slice(0, separator));\n    if (roles.length === 0) {\n      issues.push({ line: lineNumber, message: \"no role name before the colon\" });\n      continue;\n    }\n\n    const values: RoleValue[] = [];\n    for (const entry of line.slice(separator + 1).split(\",\")) {\n      const parsed = parseValue(entry.trim(), lineNumber, issues);\n      if (parsed !== undefined) values.push(parsed);\n    }\n    if (values.length === 0) {\n      issues.push({ line: lineNumber, message: `no usable value for ${roles.join(\", \")}` });\n      continue;\n    }\n    for (const role of roles) table.set(role, values);\n  }\n\n  return { table, issues };\n}\n\n/** Parse without the diagnostics. Kept for callers that only need the table. */\nexport function parseModelConfig(source: string): RoleTable {\n  return parseModelConfigWithIssues(source).table;\n}\n\nexport function parseValue(\n  value: string,\n  line = 0,\n  issues: RoleIssue[] = [],\n): RoleValue | undefined {\n  if (!value) return undefined;\n  if (INHERIT.has(value.toLowerCase())) return \"inherit-parent\";\n  const tokens = value.split(/\\s+/).filter(Boolean);\n  const [route, ...rest] = tokens;\n  if (!route) return undefined;\n\n  const slash = route.indexOf(\"/\");\n  if (slash <= 0 || slash === route.length - 1) {\n    // A bare model id with no provider cannot be routed safely; ask the harness\n    // to inherit rather than guessing a provider.\n    issues.push({\n      line,\n      message: `\"${route}\" is not <provider>/<model>, so this role inherits the parent route`,\n    });\n    return \"inherit-parent\";\n  }\n\n  let reasoningEffort: string | undefined;\n  for (const token of rest) {\n    if (EFFORTS.has(token.toLowerCase())) {\n      reasoningEffort = token.toLowerCase();\n      continue;\n    }\n    issues.push({\n      line,\n      message: `unknown effort \"${token}\"; expected one of ${REASONING_EFFORTS.join(\", \")}`,\n    });\n  }\n\n  return {\n    provider: route.slice(0, slash),\n    model: route.slice(slash + 1),\n    ...(reasoningEffort ? { reasoningEffort } : {}),\n  };\n}\n\n/** How a role name was matched, so the caller can report a near miss. */\nexport interface RoleMatch {\n  /** The key exactly as it appears in the file, after lowercasing. */\n  readonly key: string;\n  readonly values: readonly RoleValue[];\n  /** True when the key came from a shared `a, b: value` line. */\n  readonly fromList: boolean;\n}\n\n/**\n * Look a role up by name.\n *\n * The parser stores both the whole left side of a line and, when the comma list\n * is a genuine group, each part. So a direct map hit is the only match worth\n * making. Matching is exact on purpose: a near miss such as `how` against\n * `how explorer` must not resolve, because picking a route the user did not name\n * changes both cost and model without saying so. `findNearMisses` reports those\n * for a human instead.\n */\nexport function lookupRole(table: RoleTable, role: string | undefined): RoleMatch | undefined {\n  if (!role) return undefined;\n  const key = role.trim().toLowerCase().replace(/\\s+/g, \" \");\n  if (!key) return undefined;\n\n  const values = table.get(key);\n  if (!values) return undefined;\n  // `fromList` is informational: a key containing a comma came from a shared\n  // line, which is how a panel role is spelled.\n  return { key, values, fromList: key.includes(\",\") };\n}\n\n/**\n * Configured role names a caller could have meant. Used to explain a miss, not\n * to resolve one: `how` is a near miss for `how explorer`, and quietly running\n * on the explorer route would look configured while being wrong.\n */\nexport function findNearMisses(table: RoleTable, role: string): string[] {\n  const key = role.trim().toLowerCase().replace(/\\s+/g, \" \");\n  if (!key) return [];\n  const hits: string[] = [];\n  for (const candidate of table.keys()) {\n    if (candidate === key) continue;\n    if (candidate.includes(key) || key.includes(candidate)) {\n      hits.push(candidate);\n      continue;\n    }\n    // A shared line stores its parts separately too, so compare against those\n    // as well: `how` should surface both `how explorer` and `how explainer`.\n    for (const part of candidate.split(\",\").map((item) => item.trim())) {\n      if (part === key) continue;\n      if (part.includes(key) || key.includes(part)) {\n        hits.push(candidate);\n        break;\n      }\n    }\n  }\n  return [...new Set(hits)];\n}\n\n/**\n * Resolve one role to a route.\n *\n * `index` selects a panel entry and wraps, so a caller that spawns more\n * children than the list has entries still gets a deterministic route. A\n * missing role or an `inherit-parent` entry both return `undefined`, which\n * tells the caller to omit `agentOptions` and inherit.\n */\nexport function resolveRole(\n  table: RoleTable,\n  role: string | undefined,\n  index = 0,\n): Route | undefined {\n  const values = lookupRole(table, role)?.values;\n  if (!values || values.length === 0) return undefined;\n  const value = values[Math.abs(index) % values.length];\n  return value && value !== \"inherit-parent\" ? value : undefined;\n}\n\n/** Every entry for a panel role. An empty list means the role is not configured. */\nexport function resolvePanel(table: RoleTable, role: string): readonly RoleValue[] {\n  return lookupRole(table, role)?.values ?? [];\n}\n","/**\n * Read `~/.dsh/pstack-models.md`, the role file `/setup-pstack` writes.\n */\nimport { readFile } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { parseModelConfigWithIssues, type RoleIssue, type RoleTable } from \"./roles.ts\";\n\nexport function dshHome(): string {\n  return process.env.DSH_HOME || join(homedir(), \".dsh\");\n}\n\nexport function modelConfigPath(): string {\n  return join(dshHome(), \"pstack-models.md\");\n}\n\nexport interface LoadedRoleTable {\n  readonly table: RoleTable;\n  /** Parse problems, each tied to a line of the file. */\n  readonly issues: readonly RoleIssue[];\n  /** True when the file exists but could not be read. */\n  readonly unreadable: boolean;\n}\n\n/**\n * Read the role file.\n *\n * A missing file is normal and means every role inherits the parent route. A\n * malformed line degrades only that line, and the issues travel with the table\n * so the tool can name them in its reply. A read failure keeps that distinction\n * explicit instead of collapsing into an empty table.\n */\nexport async function loadRoleTable(): Promise<LoadedRoleTable> {\n  try {\n    const source = await readFile(modelConfigPath(), \"utf8\");\n    const { table, issues } = parseModelConfigWithIssues(source);\n    return { table, issues, unreadable: false };\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n      return { table: new Map(), issues: [], unreadable: false };\n    }\n    return {\n      table: new Map(),\n      issues: [\n        {\n          line: 0,\n          message: `could not read ${modelConfigPath()}: ${(error as Error).message}`,\n        },\n      ],\n      unreadable: true,\n    };\n  }\n}\n","/**\n * `pstack_subagent`: pstack's delegation surface for DSH.\n *\n * Cursor's `Task` tool gives every spawn a `subagent_type`, a model slug, and\n * background execution. DSH splits those across `ctx.subagents` (background\n * activations), the agent preset system (composition), and the LLM adapter\n * routes (model choice). This tool joins them back into one call whose shape a\n * ported pstack skill can use unchanged.\n */\nimport { readFile } from \"node:fs/promises\";\nimport type { Context } from \"@deepseek-ai/cordis\";\nimport type { Agent } from \"@deepseek-ai/dsh-agent\";\nimport type { ContentBlock } from \"@deepseek-ai/dsh-llm\";\nimport { ReasoningEffortId } from \"@deepseek-ai/dsh-llm\";\nimport type {} from \"@deepseek-ai/dsh-subagent\";\nimport { defineTool } from \"@deepseek-ai/dsh-tools\";\nimport { loadRoleTable, modelConfigPath } from \"./models.ts\";\nimport { AGENTS_ROOT, SKILLS_ROOT } from \"./paths.ts\";\nimport { findNearMisses, lookupRole, resolveRole, type Route } from \"./roles.ts\";\n\nexport const name = \"pstack-subagent\";\nexport const inject = [\"tools\", \"subagents\"];\n\nconst AGENT_KINDS = [\"poteto-agent\", \"comment-sicko\", \"general\"] as const;\nexport type AgentKind = (typeof AGENT_KINDS)[number];\n\nexport interface Config {\n  /** Tool name exposed to the model. */\n  readonly toolName?: string;\n  /** Subagent provider registered on `ctx.subagents`. */\n  readonly provider?: string;\n  /** Default agent kind when the model omits `agent`. */\n  readonly defaultAgent?: AgentKind;\n}\n\nconst POTETO_AGENT_PATH = `${AGENTS_ROOT}poteto-agent.md`;\nconst COMMENT_SICKO_PATH = `${AGENTS_ROOT}comment-sicko.md`;\nconst POTETO_MODE_PATH = `${SKILLS_ROOT}poteto-mode/SKILL.md`;\n\nexport function stripFrontmatter(source: string): string {\n  if (!source.startsWith(\"---\")) return source;\n  const end = source.indexOf(\"\\n---\", 3);\n  return end === -1 ? source : source.slice(end + 4).replace(/^\\n+/, \"\");\n}\n\nexport async function readAgentInstructions(kind: AgentKind): Promise<string> {\n  if (kind === \"general\") return \"\";\n  const path = kind === \"poteto-agent\" ? POTETO_AGENT_PATH : COMMENT_SICKO_PATH;\n  try {\n    return stripFrontmatter(await readFile(path, \"utf8\"));\n  } catch {\n    return \"\";\n  }\n}\n\n/**\n * Build the child prompt. A pstack delegate must read `poteto-mode` first, and\n * the parent normally passes its absolute path. When the parent omits it, this\n * fallback keeps the delegate from drifting into general-purpose style.\n */\nexport function composePrompt(input: {\n  readonly kind: AgentKind;\n  readonly description: string;\n  readonly prompt: string;\n  readonly agentInstructions: string;\n  readonly potetoModePath?: string;\n}): string {\n  if (input.kind === \"general\") return input.prompt;\n\n  const path = input.potetoModePath ?? POTETO_MODE_PATH;\n  const sections = [\n    input.agentInstructions.trim(),\n    `Parent task label: ${input.description}`,\n    `Read \\`${path}\\` in full before any work, including its inline Principles index. Navigate to a leaf \\`principle-*\\` skill whenever you apply that principle.`,\n    input.prompt.trim(),\n  ].filter(Boolean);\n  return sections.join(\"\\n\\n\");\n}\n\nexport interface RoleResolution {\n  readonly route: Route | undefined;\n  /** Human-readable notes to append to the tool reply: issues, near misses. */\n  readonly notes: readonly string[];\n}\n\n/**\n * Resolve the `role` argument against the shipped role table, explaining a miss\n * instead of swallowing it.\n *\n * A missing file is normal. A configured-but-unmatched role is not: it means a\n * skill and `~/.dsh/pstack-models.md` disagree, and the child would silently run\n * on the parent route. The tool reply says so, so the parent can fix the file or\n * report the miss rather than believing the route applied.\n */\nexport async function resolveRoleArg(role: string | undefined): Promise<RoleResolution> {\n  if (!role) return { route: undefined, notes: [] };\n\n  const { table, issues, unreadable } = await loadRoleTable();\n  const match = lookupRole(table, role);\n  if (match) {\n    const notes: string[] = [];\n    for (const issue of issues) {\n      if (issue.line === 0) notes.push(issue.message);\n    }\n    return { route: resolveRole(table, role), notes };\n  }\n\n  const near = findNearMisses(table, role);\n  const lines: string[] = [];\n  if (unreadable) {\n    lines.push(\n      `pstack: ${modelConfigPath()} could not be read; the child inherits the parent route.`,\n    );\n  } else if (table.size === 0) {\n    lines.push(\n      `pstack: no role table at ${modelConfigPath()}; the child inherits the parent route. Run /setup-pstack to configure roles.`,\n    );\n  } else {\n    lines.push(\n      `pstack: role \"${role}\" is not in ${modelConfigPath()}; the child inherits the parent route.`,\n    );\n    if (near.length > 0)\n      lines.push(`pstack: did you mean ${near.map((n) => `\"${n}\"`).join(\" or \")}?`);\n  }\n  return { route: undefined, notes: lines };\n}\n\nexport interface PstackToolDeps {\n  readonly start: (input: {\n    readonly parent: Agent;\n    readonly label: string;\n    readonly prompt: ContentBlock[];\n    readonly signal: AbortSignal;\n    readonly route: Route | undefined;\n    readonly cwd: string | undefined;\n  }) => Promise<{ readonly childId: string }>;\n  readonly loadAgent: (kind: AgentKind) => Promise<string>;\n  /**\n   * Resolve the `role` argument. The notes explain a miss so the reply can name\n   * it; an empty list means the route applied as written, or there was no role.\n   */\n  readonly loadRole: (role: string | undefined) => Promise<RoleResolution>;\n  readonly potetoModePath?: string;\n  readonly defaultAgent?: AgentKind;\n  readonly toolName?: string;\n}\n\n/**\n * Turn a resolved role into the `agentOptions` a child activation carries.\n *\n * This is the only place a `Route` becomes a provider request. Keeping it a\n * pure function lets a test assert the exact options without starting a child,\n * which is where a role-to-route bug would otherwise stay invisible until a\n * live delegation picked the wrong model.\n */\nexport function routeToAgentOptions(\n  route: Route | undefined,\n): { provider: string; model: string; reasoningEffort?: ReasoningEffortId } | undefined {\n  if (!route) return undefined;\n  return {\n    provider: route.provider,\n    model: route.model,\n    ...(route.reasoningEffort ? { reasoningEffort: ReasoningEffortId(route.reasoningEffort) } : {}),\n  };\n}\n\n/** Tool definition over injected dependencies; `apply` supplies the runtime. */\nexport function createPstackTool(deps: PstackToolDeps) {\n  return defineTool({\n    name: deps.toolName ?? \"pstack_subagent\",\n    description:\n      'Delegate a self-contained task to a pstack subagent. Use `agent: \"poteto-agent\"` for code-writing delegates and helper tasks spawned inside a /poteto-mode playbook step. Use `agent: \"general\"` for workflow reviewers such as how, why, arena, swarm, interrogate, and reflect. Use `agent: \"comment-sicko\"` only through /no-comments. Pass `role` to select the route configured in ~/.dsh/pstack-models.md; omit it to inherit the parent route. The call returns the child id immediately and the runtime reports the final answer in a completion notice.',\n    parameters: {\n      description: {\n        type: \"string\",\n        description: \"A short (3-5 word) description of the delegated task, for display.\",\n        required: true,\n      },\n      prompt: {\n        type: \"string\",\n        description:\n          \"The complete, self-contained task for the subagent. It does not share this conversation, so include context, file pointers, constraints, and the check that proves the work.\",\n        required: true,\n      },\n      agent: {\n        type: \"string\",\n        enum: AGENT_KINDS,\n        description:\n          \"poteto-agent (default) for pstack delegates; general for workflow reviewers; comment-sicko for comment review.\",\n      },\n      role: {\n        type: \"string\",\n        description:\n          'Role line in ~/.dsh/pstack-models.md, such as \"feature, refactoring\" or \"judgment and prose\". Omit to inherit the parent route.',\n      },\n      cwd: {\n        type: \"string\",\n        description: \"Initial child working directory. Omit to inherit the parent directory.\",\n      },\n    },\n    output: {\n      schema: { type: \"string\" },\n      render: (_args, value) => [{ type: \"text\", text: value }],\n    },\n    async execute(args, exec) {\n      const parent = exec.agent;\n      if (!parent) throw new Error(\"pstack_subagent requires an agent context\");\n\n      const kind = (args.agent ?? deps.defaultAgent ?? \"poteto-agent\") as AgentKind;\n      const agentInstructions = await deps.loadAgent(kind);\n      const prompt = composePrompt({\n        kind,\n        description: args.description,\n        prompt: args.prompt,\n        agentInstructions,\n        ...(deps.potetoModePath ? { potetoModePath: deps.potetoModePath } : {}),\n      });\n      const { route, notes } = await deps.loadRole(args.role);\n\n      const activation = await deps.start({\n        parent,\n        label: args.description,\n        prompt: [{ type: \"text\", text: prompt }],\n        signal: exec.signal,\n        route,\n        cwd: args.cwd,\n      });\n\n      const started = `started subagent ${activation.childId}`;\n      return notes.length > 0 ? [started, ...notes].join(\"\\n\") : started;\n    },\n  });\n}\n\n/**\n * Build the provider-facing activation request for one child.\n *\n * A role is resolved once, at delegation time, into concrete provider options.\n * The child inherits the parent route when the role is absent or resolves to\n * `inherit-parent`, which is why the field is omitted rather than set to a\n * placeholder.\n */\nexport function buildActivationRequest(input: {\n  readonly parent: Agent;\n  readonly prompt: ContentBlock[];\n  readonly route: Route | undefined;\n  readonly cwd: string | undefined;\n}): {\n  parent: Agent;\n  prompt: ContentBlock[];\n  cwd?: string;\n  agentOptions?: { provider: string; model: string; reasoningEffort?: ReasoningEffortId };\n} {\n  const options = routeToAgentOptions(input.route);\n  return {\n    parent: input.parent,\n    prompt: input.prompt,\n    ...(input.cwd ? { cwd: input.cwd } : {}),\n    ...(options ? { agentOptions: options } : {}),\n  };\n}\n\n/**\n * Mount the tool. `ctx.subagents` owns child lifecycle; this row only supplies\n * the pstack-specific shape (agent preambles and role routes) on top.\n */\nexport function apply(ctx: Context, config: Config = {}): void {\n  const providerName = config.provider ?? \"spawn\";\n\n  const tool = createPstackTool({\n    async start({ parent, label, prompt, signal, route, cwd }) {\n      const activation = await ctx.subagents.startActivation({\n        provider: providerName,\n        label,\n        signal,\n        delivery: \"parent\",\n        request: buildActivationRequest({ parent, prompt, route, cwd }),\n      });\n      return { childId: String(activation.childId) };\n    },\n    loadAgent: readAgentInstructions,\n    loadRole: resolveRoleArg,\n    potetoModePath: POTETO_MODE_PATH,\n    ...(config.defaultAgent ? { defaultAgent: config.defaultAgent } : {}),\n    ...(config.toolName ? { toolName: config.toolName } : {}),\n  });\n  ctx.tools.register(tool);\n}\n"],"mappings":"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"}
+{"version":3,"file":"subagent.mjs","names":["describeError","describeError"],"sources":["../scripts/role-manifest.ts","../src/effort.ts","../src/roles.ts","../src/models.ts","../src/subagent.ts"],"sourcesContent":["/**\n * The one pstack role manifest.\n *\n * Every consumer of the role vocabulary reads this module: `src/roles.ts` for\n * exact lookup and panel classification, `src/models.ts` for value shapes,\n * `scripts/build-assets.ts` for the generated example file, and the\n * `setup-pstack` skill text, which points at that example instead of listing the\n * roles again. A second literal role list anywhere is a bug.\n *\n * Keys are matched exactly after normalization. Commas are part of some keys\n * (`feature, refactoring`), so nothing here may be split on a comma.\n *\n * This module has no Node imports: the Host bundle imports it directly.\n */\n\n/** Whether a role holds one route or a comma-separated list of routes. */\nexport type RoleValueShape = \"single\" | \"list\";\n\nexport interface RoleSpec {\n  /** Exact key as written in the role file. Commas belong to the key. */\n  readonly key: string;\n  readonly shape: RoleValueShape;\n  /**\n   * A list role that automatically starts one child per entry. Only the three\n   * panel roles set this; every other list role selects one entry.\n   */\n  readonly autoPanel: boolean;\n  /** Skills and playbooks that read this role. */\n  readonly consumers: readonly string[];\n  readonly summary: string;\n}\n\n/** File name the role policy lives under inside `$DSH_HOME`. */\nexport const PSTACK_MODELS_FILENAME = \"pstack-models.md\";\n\n/** Asset path, relative to `assets/`, of the generated shape reference. */\nexport const PSTACK_MODELS_EXAMPLE_PATH = \"docs/pstack-models.example.md\";\n\n/** Values that resolve to \"send no `agentOptions` and inherit the parent route\". */\nexport const INHERIT_PARENT_ALIASES: readonly string[] = [\"inherit-parent\", \"auto\"];\n\nexport const ROLE_MANIFEST: readonly RoleSpec[] = [\n  {\n    key: \"feature, refactoring\",\n    shape: \"single\",\n    autoPanel: false,\n    consumers: [\"poteto-mode/playbooks/feature.md\", \"poteto-mode/playbooks/refactoring.md\"],\n    summary:\n      \"One route for both code playbooks. The comma joins two playbook names into a single key.\",\n  },\n  {\n    key: \"bug-fix\",\n    shape: \"single\",\n    autoPanel: false,\n    consumers: [\"poteto-mode/playbooks/bug-fix.md\"],\n    summary: \"Implementation route for the bug-fix playbook.\",\n  },\n  {\n    key: \"perf-issue\",\n    shape: \"single\",\n    autoPanel: false,\n    consumers: [\"poteto-mode/playbooks/perf-issue.md\"],\n    summary: \"Implementation route for the perf-issue playbook.\",\n  },\n  {\n    key: \"hillclimb\",\n    shape: \"single\",\n    autoPanel: false,\n    consumers: [\"poteto-mode/playbooks/hillclimb.md\"],\n    summary: \"Implementation route for the hillclimb playbook.\",\n  },\n  {\n    key: \"judgment and prose\",\n    shape: \"single\",\n    autoPanel: false,\n    consumers: [\"poteto-mode/SKILL.md\", \"unslop\", \"technical-writing\"],\n    summary: \"Route for prose work and vague-instruction judgment calls.\",\n  },\n  {\n    key: \"hardest tasks\",\n    shape: \"single\",\n    autoPanel: false,\n    consumers: [\"poteto-mode/SKILL.md\"],\n    summary: \"Route for the strongest judgment model on cross-cutting or subtle work.\",\n  },\n  {\n    key: \"how explorer\",\n    shape: \"single\",\n    autoPanel: false,\n    consumers: [\"how/SKILL.md\", \"how/references/explorer-prompt.md\"],\n    summary: \"Route for each how explorer child.\",\n  },\n  {\n    key: \"how explainer\",\n    shape: \"single\",\n    autoPanel: false,\n    consumers: [\"how/SKILL.md\", \"how/references/explainer-prompt.md\"],\n    summary: \"Route for the single how explainer child.\",\n  },\n  {\n    key: \"why investigators\",\n    shape: \"single\",\n    autoPanel: false,\n    consumers: [\"why/SKILL.md\", \"why/references/investigator-prompt.md\"],\n    summary: \"Route for each why investigator child.\",\n  },\n  {\n    key: \"why synthesizer\",\n    shape: \"single\",\n    autoPanel: false,\n    consumers: [\"why/SKILL.md\", \"why/references/synthesizer-prompt.md\"],\n    summary: \"Route for the why synthesis child.\",\n  },\n  {\n    key: \"reflect tooling\",\n    shape: \"single\",\n    autoPanel: false,\n    consumers: [\"reflect/SKILL.md\", \"reflect/references/tooling-reviewer.md\"],\n    summary: \"Route for the reflect tooling reviewer.\",\n  },\n  {\n    key: \"reflect judgment, divergent, synthesizer\",\n    shape: \"single\",\n    autoPanel: false,\n    consumers: [\n      \"reflect/SKILL.md\",\n      \"reflect/references/judgment-reviewer.md\",\n      \"reflect/references/divergent-reviewer.md\",\n      \"reflect/references/synthesizer.md\",\n    ],\n    summary:\n      \"One shared route for the judgment reviewer, the divergent reviewer, and the synthesizer. The commas belong to the key.\",\n  },\n  {\n    key: \"arena runners\",\n    shape: \"list\",\n    autoPanel: true,\n    consumers: [\"arena/SKILL.md\"],\n    summary: \"Panel: one arena child per entry, all started together.\",\n  },\n  {\n    key: \"arena cross-judge pool\",\n    shape: \"list\",\n    autoPanel: false,\n    consumers: [\"arena/SKILL.md\"],\n    summary:\n      \"A pool arena picks one entry from, preferring a model family unlike the parent's. Not fanned out automatically.\",\n  },\n  {\n    key: \"swarm workers\",\n    shape: \"list\",\n    autoPanel: false,\n    consumers: [\"swarm/SKILL.md\", \"poteto-mode/playbooks/multi-phase-plan.md\"],\n    summary:\n      \"One default route for every worker. A race gives each arm another entry through `roleIndex`, and the caller still starts one worker per call.\",\n  },\n  {\n    key: \"architect runners\",\n    shape: \"list\",\n    autoPanel: true,\n    consumers: [\"architect/SKILL.md\"],\n    summary: \"Panel: one architect child per entry, all started together.\",\n  },\n  {\n    key: \"interrogate reviewers\",\n    shape: \"list\",\n    autoPanel: true,\n    consumers: [\"interrogate/SKILL.md\"],\n    summary: \"Panel: one interrogate reviewer per entry, all started together.\",\n  },\n];\n\n/** Every exact role key, in manifest order. */\nexport const ROLE_KEYS: readonly string[] = ROLE_MANIFEST.map((role) => role.key);\n\n/** Keys whose list value expands to one child per entry automatically. */\nexport const AUTO_PANEL_ROLE_KEYS: readonly string[] = ROLE_MANIFEST.filter(\n  (role) => role.autoPanel,\n).map((role) => role.key);\n\n/** The four setup-pstack budget tiers and the effort each one targets. */\nexport interface BudgetTier {\n  readonly label: string;\n  /** Target effort token; the model's supported list decides whether it applies. */\n  readonly effort: string;\n  readonly description: string;\n}\n\nexport const BUDGET_TIERS: readonly BudgetTier[] = [\n  { label: \"unlimited\", effort: \"max\", description: \"max reasoning\" },\n  { label: \"large\", effort: \"xhigh\", description: \"xhigh reasoning\" },\n  { label: \"medium\", effort: \"high\", description: \"high reasoning\" },\n  { label: \"small\", effort: \"medium\", description: \"medium reasoning\" },\n];\n\n/** Exact manifest lookup. Callers normalize the key first. */\nexport function findRoleSpec(key: string): RoleSpec | undefined {\n  return ROLE_MANIFEST.find((role) => role.key === key);\n}\n\n/**\n * Render the role-file shape reference shipped as a generated asset.\n *\n * The output is itself a valid role file: every explanatory line is a `#` comment,\n * so copying it verbatim yields a working policy where every role inherits the\n * parent route. That is what makes `/setup-pstack` safe to re-run and makes the\n * example a convergence baseline rather than prose that happens to look like one.\n *\n * The defaults are `inherit-parent` for every role because this package cannot\n * know which routes a deployment serves. `setup-pstack` replaces them with routes\n * the user confirmed, never with a model id guessed here.\n */\nexport function renderPstackModelsExample(): string {\n  const roles = ROLE_MANIFEST.map((role) => `${role.key}: inherit-parent`);\n  return [\n    \"# pstack per-role model configuration\",\n    \"#\",\n    \"# `/setup-pstack` writes this file to `$DSH_HOME/pstack-models.md`. `pstack_subagent`\",\n    \"# re-reads it on every delegation, so an edit reaches the next child and never a child\",\n    \"# that already started.\",\n    \"#\",\n    \"# One line per role. The key must match a role in the manifest exactly, commas\",\n    \"# included. Delete a line to inherit the parent route for that role.\",\n    \"#\",\n    \"# Value forms:\",\n    \"#\",\n    \"# - `inherit-parent` or `auto` sends no `agentOptions`, so the child runs on the parent\",\n    \"#   route.\",\n    \"# - `<provider>/<model>` is an exact route. It splits at the first `/`: the\",\n    \"#   provider is the text before it and the model is everything after it, so\",\n    \"#   `gateway/vendor-a/model-x` is provider `gateway` with model\",\n    \"#   `vendor-a/model-x`. No segment may be empty.\",\n    \"# - `<provider>/<model> [effort]` sets the starting level for that role. A caller\",\n    \"#   raises or lowers it per delegation with `reasoningEffort`, and a running child\",\n    \"#   can change its own with `set_reasoning_effort`. The effort must appear in that\",\n    \"#   model's supported effort list. This package assumes no ladder of its own, so it\",\n    \"#   never invents a token and reports the real ones whenever it refuses one.\",\n    \"#\",\n    \"# `arena runners`, `architect runners`, and `interrogate reviewers` are panels: the\",\n    \"# value is a comma-separated list and one child starts per entry. Two entries on the\",\n    \"# same route are not a cross-model review, and `pstack_subagent` says so in its\",\n    \"# result.\",\n    \"#\",\n    \"# `arena cross-judge pool` is a list too, but it is not fanned out; pass `roleIndex` to\",\n    \"# choose the entry. `swarm workers` is a list as well: its first entry is the default\",\n    \"# route for every worker, `roleIndex` gives one race arm a different entry, and the\",\n    \"# caller still starts each worker itself.\",\n    \"#\",\n    \"# The defaults below are `inherit-parent` because no route is confirmed yet. Replace\",\n    \"# them with routes your own deployment serves.\",\n    \"#\",\n    \"# budget: none (unset)\",\n    ...roles,\n    \"\",\n  ].join(\"\\n\");\n}\n","/**\n * Reasoning-effort control, at both ends of one delegation.\n *\n * A role line names the effort a child *starts* at. That value is a baseline, not a\n * verdict:\n *\n * 1. the caller may override it for one delegation with `reasoningEffort`\n *    (validated in `src/subagent.ts` before the first child starts);\n * 2. a running child may raise or lower it with `set_reasoning_effort`, which this\n *    module installs on that child's own scope.\n *\n * Both halves exist because the two people who know the right level are not the same\n * person: only the caller knows the job, and only the child knows what it found once\n * it started reading the code.\n *\n * **The effort vocabulary belongs to the adapter.** This module never carries a\n * ladder of its own. A token is accepted only when the model the child will actually\n * request advertises it in `reasoning.efforts`, and a rejection lists that model's\n * real values. A hardcoded list (`max`/`xhigh`/…) would both invent a universal\n * ladder and reject a deployment that names its efforts differently, which is why\n * `docs/decisions/2026-10-26-dynamic-reasoning-effort.md` records that shape as the\n * rejected alternative.\n *\n * @module\n */\n\nimport type {\n  Agent,\n  AgentOptions,\n  JsonSchemaNode,\n  LlmCallConfig,\n  LlmHost,\n  ToolDefinition,\n} from \"./host-contract.ts\";\nimport type { ChildRoute } from \"./models.ts\";\n\n/** Model-facing name of the child's own control. */\nexport const SET_EFFORT_TOOL = \"set_reasoning_effort\";\n\n/** One exact route an effort applies to. */\nexport interface EffortTarget {\n  readonly provider: string;\n  readonly model: string;\n}\n\n/**\n * Resolve the route a child's effort will actually apply to.\n *\n * The session's latest request header is the live route after a model switch, and\n * `Agent.options` is the creation-time fallback. DSH's own delegation code resolves\n * `inherit-parent` the same way, so reading `options` alone would validate a\n * different model than the child really inherits.\n *\n * An explicit route wins over both, because it is what the delegation will request.\n */\nexport function resolveEffortTarget(\n  agent: Agent | undefined,\n  route?: ChildRoute,\n): EffortTarget | undefined {\n  const explicit = route?.kind === \"route\" ? route : undefined;\n  const header = agent?.session.requestHeader()?.config;\n\n  const provider = explicit?.provider ?? header?.provider ?? agent?.options.provider;\n  const model = explicit?.model ?? header?.model ?? agent?.options.model;\n  return provider !== undefined && model !== undefined ? { provider, model } : undefined;\n}\n\n/** The efforts one route advertises, in the adapter's own order. */\nasync function advertisedEfforts(\n  llm: LlmHost,\n  target: EffortTarget,\n  signal: AbortSignal | undefined,\n): Promise<readonly string[]> {\n  const info = await llm.resolveModelInfo(target.provider, target.model, signal);\n  return info.reasoning?.efforts.map((entry) => entry.id) ?? [];\n}\n\n/**\n * Validate one effort against the route a child will actually request.\n *\n * Rejects with the target's real effort list rather than a generic message, because\n * \"max is not supported\" leaves the caller guessing while \"supports xhigh, high,\n * medium\" is actionable. A model that advertises no efforts at all is reported\n * separately: that is a route incapable of the control, not a wrong token.\n */\nexport async function validateEffortFor(\n  llm: LlmHost,\n  route: ChildRoute | undefined,\n  effort: string,\n  parent: Agent | undefined,\n  signal?: AbortSignal,\n): Promise<void> {\n  const target = resolveEffortTarget(parent, route);\n  if (target === undefined) {\n    throw new Error(\n      \"cannot resolve the child provider/model route for reasoningEffort. Pass `role` with an exact route, or run the delegation from a session that has already made a request.\",\n    );\n  }\n\n  let efforts: readonly string[];\n  try {\n    efforts = await advertisedEfforts(llm, target, signal);\n  } catch (error) {\n    throw new Error(\n      `route ${target.provider}/${target.model} could not be resolved for reasoningEffort: ${describeError(error)}`,\n      { cause: error },\n    );\n  }\n\n  if (efforts.length === 0) {\n    throw new Error(\n      `${target.provider}/${target.model} advertises no reasoning efforts, so it cannot take reasoningEffort \"${effort}\". Omit the argument and let the adapter use its own default.`,\n    );\n  }\n  if (!efforts.includes(effort)) {\n    throw new Error(\n      `${target.provider}/${target.model} does not support reasoning effort \"${effort}\". It supports: ${efforts.join(\", \")}.`,\n    );\n  }\n}\n\n/**\n * Install the effort control on one live child.\n *\n * Registration is child-scoped, so the waterfall and the tool dispose with the\n * child: a sibling delegation never sees them, and a later child cannot inherit a\n * stale value.\n *\n * The waterfall re-states the starting effort on every request and applies a\n * change from the next request onward. It never rewrites a request already in\n * flight, because `next()` has already been called and its result is the request\n * the machine built.\n *\n * A missing route is not fatal here. The child still runs on whatever the adapter\n * chose; the tool reports the missing route when the child tries to change effort.\n *\n * @param child - the live child agent, already started.\n * @param llm - the adapter host used to validate a requested change.\n * @param initialEffort - the effort the delegation started the child at, if any.\n * @returns a disposer that unwinds this contribution early, or does nothing when\n * the child context is already gone.\n */\nexport function installEffortControl(\n  child: Agent,\n  llm: LlmHost,\n  initialEffort: string | undefined,\n): () => void {\n  let current = initialEffort;\n\n  const disposeListener = child.ctx.on(\"agent/request\", async (_payload, next) => {\n    const config = await next();\n    return current === undefined\n      ? config\n      : ({ ...config, reasoningEffort: current } satisfies LlmCallConfig);\n  });\n\n  const disposeTool = child.ctx.tools.register(\n    defineSetEffortTool(child, llm, (effort) => {\n      current = effort;\n    }),\n  );\n\n  return () => {\n    disposeTool();\n    disposeListener();\n  };\n}\n\n/** The child's own view of its effort, for the tool body. */\nfunction defineSetEffortTool(\n  child: Agent,\n  llm: LlmHost,\n  apply: (effort: string) => void,\n): ToolDefinition {\n  const parameters: Record<string, unknown> = {\n    effort: {\n      type: \"string\",\n      description:\n        \"The reasoning effort to use from your next step onward. Use one of the values this model advertises; the call rejects an unknown one and lists the real values.\",\n    },\n  };\n\n  const outputSchema: JsonSchemaNode = { type: \"string\" };\n\n  return {\n    name: SET_EFFORT_TOOL,\n    description: [\n      \"Change your reasoning effort for future model requests.\",\n      \"Use it when the task turns out harder or more routine than the role line assumed: raise it for subtle design, concurrency, or algorithm work, lower it once the remaining work is mechanical.\",\n      \"The change applies from your next step; a request already in flight is unaffected, and it lasts for the rest of this child's life.\",\n      \"This tool may not be visible until your second step. The effort you were started with applies to the first step, so a slow first step is expected when that level is high.\",\n    ].join(\" \"),\n    parameters,\n    output: {\n      schema: outputSchema,\n      render: (_args, value) => [{ type: \"text\", text: String(value) }],\n    },\n    isConcurrencySafe: () => false,\n    async execute(rawArgs, exec) {\n      const args = rawArgs as { effort?: unknown };\n      const value = typeof args.effort === \"string\" ? args.effort.trim() : \"\";\n      if (value === \"\") {\n        throw new Error(\n          \"set_reasoning_effort needs a non-empty `effort`. Pass the exact token this model advertises; an empty value would silently re-enable the adapter default.\",\n        );\n      }\n\n      const target = resolveEffortTarget(exec.agent ?? child);\n      if (target === undefined) {\n        throw new Error(\n          \"this child has no resolved provider/model route, so reasoning effort cannot be validated against the live adapter metadata\",\n        );\n      }\n\n      let efforts: readonly string[];\n      try {\n        efforts = await advertisedEfforts(llm, target, exec.signal);\n      } catch (error) {\n        throw new Error(\n          `${target.provider}/${target.model} could not be resolved for reasoning effort: ${describeError(error)}`,\n          { cause: error },\n        );\n      }\n      if (efforts.length === 0) {\n        throw new Error(\n          `${target.provider}/${target.model} advertises no reasoning efforts, so this child has none to change. Your current effort stays as it is.`,\n        );\n      }\n      if (!efforts.includes(value)) {\n        throw new Error(\n          `${target.provider}/${target.model} does not support reasoning effort \"${value}\", so nothing changed. It supports: ${efforts.join(\", \")}.`,\n        );\n      }\n\n      apply(value);\n      return `reasoning effort set to \"${value}\". It applies from your next step; the request already in flight is unaffected.`;\n    },\n  };\n}\n\n/**\n * The `agentOptions` one (route, effort override) pair contributes.\n *\n * The two independent halves are easy to get wrong in opposite directions:\n *\n * - an inherit-parent route with an override must still send `reasoningEffort`,\n *   which means `{ reasoningEffort }` on its own is a real `agentOptions` value and\n *   the backend still has to support the capability;\n * - an override always wins over the role line, because the caller asked for this\n *   delegation specifically.\n */\nexport function agentOptionsFor(\n  route: ChildRoute,\n  effortOverride?: string,\n): AgentOptions | undefined {\n  const effort = effortOverride ?? (route.kind === \"route\" ? route.effort : undefined);\n  if (route.kind === \"inherit\") {\n    return effort === undefined ? undefined : { reasoningEffort: effort };\n  }\n  return {\n    provider: route.provider,\n    model: route.model,\n    ...(effort === undefined ? {} : { reasoningEffort: effort }),\n  };\n}\n\n/** The effort a plan entry will actually run at, override included. */\nexport function effectiveEffort(route: ChildRoute, effortOverride?: string): string | undefined {\n  return effortOverride ?? (route.kind === \"route\" ? route.effort : undefined);\n}\n\nfunction describeError(error: unknown): string {\n  if (error instanceof Error) {\n    const code = (error as { code?: unknown }).code;\n    return typeof code === \"string\" ? `${error.message} (${code})` : error.message;\n  }\n  return String(error);\n}\n","/**\n * Role lookup over the single manifest in `scripts/role-manifest.ts`.\n *\n * A role name is matched exactly after normalization. A near miss is reported as\n * a hint and never guessed, because silently running a role on the wrong route is\n * worse than refusing the delegation.\n *\n * Commas belong to some keys (`feature, refactoring`), so nothing here splits a\n * key on a comma. Only a role file *value* is a comma-separated list.\n */\n\nimport {\n  AUTO_PANEL_ROLE_KEYS,\n  ROLE_MANIFEST,\n  findRoleSpec,\n  type RoleSpec,\n  type RoleValueShape,\n} from \"../scripts/role-manifest.ts\";\n\nexport { AUTO_PANEL_ROLE_KEYS, ROLE_MANIFEST, findRoleSpec, type RoleSpec, type RoleValueShape };\n\n/** Raised when a role name does not match the manifest. */\nexport class RoleNameError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"RoleNameError\";\n  }\n}\n\n/**\n * Normalize a role name for lookup.\n *\n * Case, surrounding whitespace, runs of whitespace, spacing around a comma, and a\n * trailing colon are formatting, not naming. Nothing else is normalized: a\n * different word is a different role.\n */\nexport function normalizeRoleName(raw: string): string {\n  return raw\n    .normalize(\"NFC\")\n    .trim()\n    .toLowerCase()\n    .replace(/\\s+/g, \" \")\n    .replace(/\\s*,\\s*/g, \", \")\n    .replace(/:+$/, \"\")\n    .trim();\n}\n\n/** Every exact role key in manifest order. */\nexport function roleKeys(): readonly string[] {\n  return ROLE_MANIFEST.map((role) => role.key);\n}\n\n/** Look a role up by its exact normalized key. */\nexport function lookupRole(raw: string): RoleSpec | undefined {\n  return findRoleSpec(normalizeRoleName(raw));\n}\n\n/**\n * Near-miss hints for a role name that did not match.\n *\n * Only used to build a diagnostic. A suggestion is never turned into a selection.\n */\nexport function suggestRoles(raw: string, limit = 3): readonly string[] {\n  const target = normalizeRoleName(raw);\n  if (target === \"\") return [];\n\n  const scored = ROLE_MANIFEST.map((role) => {\n    const shared = sharedTokenCount(target, role.key);\n    const distance = editDistance(target, role.key);\n    const contains = role.key.includes(target) || target.includes(role.key);\n    const score =\n      (contains ? 1000 : 0) + shared * 100 - distance + Math.min(role.key.length, target.length);\n    return { key: role.key, score, distance, shared, contains };\n  }).filter((candidate) => candidate.contains || candidate.shared > 0 || candidate.distance <= 4);\n\n  return scored\n    .sort((left, right) => right.score - left.score)\n    .slice(0, limit)\n    .map((candidate) => candidate.key);\n}\n\n/**\n * Resolve a role name, or throw a diagnostic that names the near misses.\n */\nexport function requireRole(raw: string): RoleSpec {\n  const spec = lookupRole(raw);\n  if (spec !== undefined) return spec;\n\n  const suggestions = suggestRoles(raw);\n  const hint =\n    suggestions.length === 0\n      ? \"No role key is close to it.\"\n      : `Closest role keys: ${suggestions.map((key) => `\"${key}\"`).join(\", \")}.`;\n  throw new RoleNameError(\n    `unknown pstack role ${JSON.stringify(raw)}. ${hint} Role names come from the role manifest, not from free text: pass the exact key, or omit \\`role\\` to inherit the parent route.`,\n  );\n}\n\nfunction sharedTokenCount(left: string, right: string): number {\n  const rightTokens = new Set(tokenize(right));\n  return [...new Set(tokenize(left))].filter((token) => rightTokens.has(token)).length;\n}\n\nfunction tokenize(value: string): readonly string[] {\n  return value.split(/[^a-z0-9]+/).filter((token) => token !== \"\");\n}\n\n/** Levenshtein distance, iterative with one row of state. */\nfunction editDistance(left: string, right: string): number {\n  if (left === right) return 0;\n  if (left === \"\") return right.length;\n  if (right === \"\") return left.length;\n\n  let previous = Array.from({ length: right.length + 1 }, (_, index) => index);\n  for (let row = 1; row <= left.length; row += 1) {\n    const current: number[] = [row];\n    for (let column = 1; column <= right.length; column += 1) {\n      const substitution = (previous[column - 1] as number) + (left[row - 1] === right[column - 1] ? 0 : 1);\n      const deletion = (previous[column] as number) + 1;\n      const insertion = (current[column - 1] as number) + 1;\n      current.push(Math.min(substitution, deletion, insertion));\n    }\n    previous = current;\n  }\n  return previous[right.length] as number;\n}\n","/**\n * The pstack role file: `$DSH_HOME/pstack-models.md`.\n *\n * `pstack_subagent` reads this file again on every delegation, so a change reaches\n * the next child and never a child that already started.\n *\n * Three states are kept apart on purpose, because they need different fixes:\n *\n * - the file does not exist: no policy is configured, so every role inherits the\n *   parent route;\n * - the file exists but cannot be read: a broken installation or permission\n *   problem, reported as an error and never treated as \"no configuration\";\n * - the file loads but a line is wrong: a typo in a key, an unknown retired role,\n *   or a malformed value is reported with the line number and the near misses.\n */\n\nimport { readFileSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\n\nimport {\n  INHERIT_PARENT_ALIASES,\n  PSTACK_MODELS_FILENAME,\n  ROLE_MANIFEST,\n  type RoleSpec,\n} from \"../scripts/role-manifest.ts\";\nimport { normalizeRoleName, suggestRoles } from \"./roles.ts\";\n\n/** One resolved child route. */\nexport type ChildRoute =\n  | { readonly kind: \"inherit\" }\n  | {\n      readonly kind: \"route\";\n      readonly provider: string;\n      readonly model: string;\n      readonly effort?: string;\n    };\n\n/** A syntactically valid line for a role the manifest knows. */\nexport interface RoleFileEntry {\n  readonly line: number;\n  /** Verbatim key text from the file. */\n  readonly rawKey: string;\n  /** Normalized key that matched the manifest. */\n  readonly key: string;\n  readonly spec: RoleSpec;\n  /** Verbatim value text from the file. */\n  readonly rawValue: string;\n  readonly routes: readonly ChildRoute[];\n}\n\n/** A recoverable problem found while reading the file. */\nexport interface RoleFileIssue {\n  /** 1-based line number, when the issue belongs to one line. */\n  readonly line?: number;\n  readonly message: string;\n}\n\nexport type RoleFileRead =\n  | { readonly status: \"missing\"; readonly path: string }\n  | { readonly status: \"unreadable\"; readonly path: string; readonly reason: string }\n  | {\n      readonly status: \"loaded\";\n      readonly path: string;\n      /** The `# budget:` label the file records, when it has one. */\n      readonly budget?: string;\n      readonly roles: ReadonlyMap<string, RoleFileEntry>;\n      readonly issues: readonly RoleFileIssue[];\n    };\n\n/** Absolute path of the role file for one DSH home. */\nexport function modelsFilePath(dshHome: string): string {\n  return join(dshHome, PSTACK_MODELS_FILENAME);\n}\n\n/**\n * Resolve `$DSH_HOME` the way the Host does: the environment when set, else\n * `~/.dsh`.\n */\nexport function resolveDshHome(\n  env: Readonly<Record<string, string | undefined>> = process.env,\n  home: string = homedir(),\n): string {\n  const configured = env[\"DSH_HOME\"];\n  if (configured !== undefined && configured.trim() !== \"\") return configured;\n  return join(home, \".dsh\");\n}\n\n/** Read the role file. Never throws for a missing or unreadable file. */\nexport function readRoleFile(path: string): RoleFileRead {\n  let text: string;\n  try {\n    text = readFileSync(path, \"utf8\");\n  } catch (error) {\n    if (isMissingFile(error)) return { status: \"missing\", path };\n    return { status: \"unreadable\", path, reason: describeError(error) };\n  }\n  return parseRoleFile(text, path);\n}\n\n/** Parse role-file text. Pure: no file system access. */\nexport function parseRoleFile(text: string, path: string): RoleFileRead {\n  const issues: RoleFileIssue[] = [];\n  const roles = new Map<string, RoleFileEntry>();\n  const lines = stripFrontmatter(text).split(\"\\n\");\n  let budget: string | undefined;\n\n  lines.forEach((rawLine, index) => {\n    const line = index + 1;\n    const trimmed = rawLine.trim();\n    if (trimmed === \"\") return;\n\n    if (trimmed.startsWith(\"#\")) {\n      const match = /^#\\s*budget:\\s*(.+)$/i.exec(trimmed);\n      if (match !== null) budget = (match[1] as string).trim();\n      return;\n    }\n\n    const separator = trimmed.indexOf(\":\");\n    if (separator === -1) {\n      issues.push({\n        line,\n        message: `expected \\`<role>: <value>\\`, found ${JSON.stringify(trimmed)}`,\n      });\n      return;\n    }\n\n    const rawKey = trimmed.slice(0, separator).trim();\n    const rawValue = trimmed.slice(separator + 1).trim();\n    const key = normalizeRoleName(rawKey);\n    if (key === \"\") {\n      issues.push({ line, message: \"the role key is empty\" });\n      return;\n    }\n\n    const spec = findSpec(key);\n    if (spec === undefined) {\n      issues.push({\n        line,\n        message: unknownRoleMessage(rawKey, key),\n      });\n      return;\n    }\n\n    const parsed = parseRouteValue(rawValue);\n    for (const issue of parsed.issues) issues.push({ line, message: `${rawKey}: ${issue}` });\n    if (parsed.routes.length === 0) return;\n\n    const previous = roles.get(spec.key);\n    if (previous !== undefined) {\n      issues.push({\n        line,\n        message: `role \"${spec.key}\" is already configured on line ${previous.line}; line ${line} wins`,\n      });\n    }\n    roles.set(spec.key, { line, rawKey, key: spec.key, spec, rawValue, routes: parsed.routes });\n  });\n\n  return budget === undefined\n    ? { status: \"loaded\", path, roles, issues }\n    : { status: \"loaded\", path, budget, roles, issues };\n}\n\nexport interface RouteParseResult {\n  readonly routes: readonly ChildRoute[];\n  readonly issues: readonly string[];\n}\n\n/** Parse a role value: one route, or a comma-separated list of routes. */\nexport function parseRouteValue(raw: string): RouteParseResult {\n  const routes: ChildRoute[] = [];\n  const issues: string[] = [];\n  const segments = raw.split(\",\");\n\n  segments.forEach((segment, index) => {\n    const trimmed = segment.trim();\n    if (trimmed === \"\") {\n      // A single trailing comma is harmless; a hole in the middle is a typo.\n      if (index !== segments.length - 1) {\n        issues.push(`entry ${index + 1} of the list is empty`);\n      }\n      return;\n    }\n    const parsed = parseRoute(trimmed);\n    if (parsed.route === undefined) {\n      issues.push(parsed.issue as string);\n      return;\n    }\n    routes.push(parsed.route);\n  });\n\n  if (routes.length === 0 && issues.length === 0) {\n    issues.push(\n      \"the value is empty; use `inherit-parent`, `auto`, or `<provider>/<model> [effort]`\",\n    );\n  }\n  return { routes, issues };\n}\n\nexport interface SingleRouteParse {\n  readonly route?: ChildRoute;\n  readonly issue?: string;\n}\n\n/** Parse one entry of a role value. */\nexport function parseRoute(raw: string): SingleRouteParse {\n  const value = raw.trim();\n  if (value === \"\") {\n    return { issue: \"the value is empty\" };\n  }\n\n  if (INHERIT_PARENT_ALIASES.includes(value.toLowerCase())) {\n    return { route: { kind: \"inherit\" } };\n  }\n\n  // The provider is the text before the first `/`, and the model is everything\n  // after it, so a model id that carries its own vendor prefix stays one value.\n  // A deployment can name models as `gateway/vendor-a/model-x`, and a grammar\n  // that forbids `/` inside a model cannot route to any of them.\n  //\n  // The model is written as one or more non-empty `/`-separated segments rather\n  // than \"anything but whitespace, comma, or bracket\", because the wider class\n  // also accepts `provider//model`, `provider/vendor/`, and `provider//`. Those\n  // are not routes any adapter serves, and taking them would move the failure\n  // from this line, where it is reported with the line number, to a preflight\n  // error on the first delegation.\n  const match = /^([^\\s/,[]+)\\/([^\\s/,[\\]]+(?:\\/[^\\s/,[\\]]+)*)(?:\\s+\\[([^[\\]]*)\\])?$/.exec(value);\n  if (match === null) {\n    return {\n      issue: `${JSON.stringify(value)} is not a route; use \\`inherit-parent\\`, \\`auto\\`, or \\`<provider>/<model> [effort]\\``,\n    };\n  }\n\n  const provider = match[1] as string;\n  const model = match[2] as string;\n  const effort = match[3];\n\n  if (effort === undefined) {\n    return { route: { kind: \"route\", provider, model } };\n  }\n  const trimmedEffort = effort.trim();\n  if (trimmedEffort === \"\") {\n    return {\n      issue: `${JSON.stringify(value)} has empty brackets; write \\`<provider>/<model> [effort]\\` or drop the brackets`,\n    };\n  }\n  if (/\\s/.test(trimmedEffort)) {\n    return {\n      issue: `${JSON.stringify(value)} has a multi-word effort; an effort is one adapter-owned token`,\n    };\n  }\n  return { route: { kind: \"route\", provider, model, effort: trimmedEffort } };\n}\n\n/** How one role's value expands into children. */\nexport type RouteSelectionMode = \"single\" | \"panel\" | \"selected\";\n\nexport interface RouteSelection {\n  readonly role: RoleSpec;\n  readonly mode: RouteSelectionMode;\n  /** Whether the role came from the file or from the inherit-parent fallback. */\n  readonly configured: boolean;\n  readonly routes: readonly ChildRoute[];\n  /** How many entries the role holds, before selection. */\n  readonly total: number;\n  readonly roleIndex?: number;\n  readonly issues: readonly string[];\n}\n\n/** Raised when a role's configured list cannot be selected from. */\nexport class RouteSelectionError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"RouteSelectionError\";\n  }\n}\n\n/**\n * Expand one role into the routes this call starts.\n *\n * The three auto-panel roles start one child per entry. Another list role selects\n * one entry, the first by default, and `roleIndex` chooses which. A single role\n * holds exactly one route and rejects `roleIndex`.\n */\nexport function selectRoleRoutes(\n  spec: RoleSpec,\n  entry: RoleFileEntry | undefined,\n  roleIndex: number | undefined,\n): RouteSelection {\n  if (spec.shape === \"single\" && roleIndex !== undefined) {\n    throw new RouteSelectionError(\n      `role \"${spec.key}\" holds a single route, so \\`roleIndex\\` does not apply; drop \\`roleIndex\\` or use a list-valued role (${listRoleKeys().join(\", \")})`,\n    );\n  }\n  if (spec.autoPanel && roleIndex !== undefined) {\n    throw new RouteSelectionError(\n      `role \"${spec.key}\" is an automatic panel: it starts one child per entry, so \\`roleIndex\\` does not apply; configure the entries you want in ${PSTACK_MODELS_FILENAME}`,\n    );\n  }\n\n  if (entry === undefined) {\n    return {\n      role: spec,\n      mode: spec.autoPanel ? \"panel\" : \"single\",\n      configured: false,\n      routes: [{ kind: \"inherit\" }],\n      total: 1,\n      issues: [],\n    };\n  }\n\n  if (spec.autoPanel) {\n    return {\n      role: spec,\n      mode: \"panel\",\n      configured: true,\n      routes: entry.routes,\n      total: entry.routes.length,\n      issues: [],\n    };\n  }\n\n  if (spec.shape === \"list\") {\n    const index = roleIndex ?? 0;\n    if (index >= entry.routes.length) {\n      throw new RouteSelectionError(\n        `role \"${spec.key}\" has ${entry.routes.length} entr${entry.routes.length === 1 ? \"y\" : \"ies\"}, so \\`roleIndex\\` ${index} is out of range; valid indexes are ${entry.routes\n          .map((_route, position) => position)\n          .join(\", \")}`,\n      );\n    }\n    return {\n      role: spec,\n      mode: \"selected\",\n      configured: true,\n      routes: [entry.routes[index] as ChildRoute],\n      total: entry.routes.length,\n      roleIndex: index,\n      issues: [],\n    };\n  }\n\n  return {\n    role: spec,\n    mode: \"single\",\n    configured: true,\n    routes: [entry.routes[0] as ChildRoute],\n    total: entry.routes.length,\n    issues: [],\n  };\n}\n\n/** Keys of the list-valued roles, including the automatic panels. */\nexport function listRoleKeys(): readonly string[] {\n  return ROLE_MANIFEST.filter((role) => role.shape === \"list\").map((role) => role.key);\n}\n\nfunction findSpec(key: string): RoleSpec | undefined {\n  return ROLE_MANIFEST.find((role) => role.key === key);\n}\n\nfunction unknownRoleMessage(rawKey: string, key: string): string {\n  const suggestions = suggestRoles(key);\n  const hint =\n    suggestions.length === 0\n      ? \"no role key is close to it\"\n      : `closest role keys: ${suggestions.map((candidate) => `\"${candidate}\"`).join(\", \")}`;\n  return `unknown role ${JSON.stringify(rawKey)} (${hint}). A line for a retired or misspelled role would otherwise be ignored, so it is reported instead.`;\n}\n\nfunction stripFrontmatter(text: string): string {\n  const normalized = text.replaceAll(\"\\r\\n\", \"\\n\");\n  if (!normalized.startsWith(\"---\\n\")) return normalized;\n  const end = normalized.indexOf(\"\\n---\", 3);\n  if (end === -1) return normalized;\n  const after = normalized.indexOf(\"\\n\", end + 1);\n  return after === -1 ? \"\" : normalized.slice(after + 1);\n}\n\nfunction isMissingFile(error: unknown): boolean {\n  return (\n    typeof error === \"object\" &&\n    error !== null &&\n    (error as { code?: unknown }).code === \"ENOENT\"\n  );\n}\n\nfunction describeError(error: unknown): string {\n  if (error instanceof Error) {\n    const code = (error as { code?: unknown }).code;\n    return typeof code === \"string\" ? `${code}: ${error.message}` : error.message;\n  }\n  return String(error);\n}\n","/**\n * `pstack_subagent`: pstack's delegation entry point.\n *\n * One call plans one or more fresh children, validates everything before the first\n * start, then starts them through `ctx.subagents.startActivation` with parent\n * delivery. Results arrive as completion notices; this module never polls.\n *\n * Validation order follows the design's delegation flow, and every check that can\n * reject a call happens before the first child starts, except a start failure in\n * the middle of a panel, which keeps the children already running and names them.\n */\n\nimport { readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nimport { PSTACK_MODELS_FILENAME } from \"../scripts/role-manifest.ts\";\nimport { parseFrontmatter } from \"./frontmatter.ts\";\nimport type {\n  Agent,\n  AgentOptions,\n  AgentsHost,\n  JsonSchemaNode,\n  LlmHost,\n  SubagentCapabilities,\n  SubagentsHost,\n  TextBlock,\n  ToolDefinition,\n  ToolRunContext,\n  ToolsHost,\n} from \"./host-contract.ts\";\nimport {\n  SET_EFFORT_TOOL,\n  agentOptionsFor,\n  effectiveEffort,\n  installEffortControl,\n  validateEffortFor,\n} from \"./effort.ts\";\nimport {\n  modelsFilePath,\n  readRoleFile,\n  resolveDshHome,\n  selectRoleRoutes,\n  type ChildRoute,\n  type RouteSelection,\n} from \"./models.ts\";\nimport { ASSETS_ROOT, POTETO_MODE_SKILL_PATH, agentPreamblePath } from \"./paths.ts\";\nimport { requireRole, type RoleSpec } from \"./roles.ts\";\n\n/** Cordis row name, used by Loader diagnostics. */\nexport const name = \"pstack-subagent\";\n\n/**\n * Delegation needs the tool registry, the subagent registry, and the LLM adapters.\n *\n * `agents` is deliberately **not** here. It is used only to reach a child this tool\n * has just started, and a composition without it still delegates: the children keep\n * the effort their request carried and cannot change it afterwards. Declaring it as\n * a hard dependency would make the whole row inert in such a profile, so the tool\n * would not exist at all — the failure `pstack-history` already paid for once with\n * `sessionQuery`. It is read per call through `ctx.get(\"agents\")` instead, which is\n * why a controller mounted after this row is still seen.\n */\nexport const inject = [\"tools\", \"subagents\", \"llm\"];\n\n/** Model-facing tool name. */\nexport const TOOL_NAME = \"pstack_subagent\";\n\n/** Backend used when the row does not name one. */\nexport const DEFAULT_SUBAGENT_PROVIDER = \"spawn\";\n\n/** Agent type used when the call does not name one. */\nexport const DEFAULT_AGENT_KIND = \"poteto-agent\";\n\n/** The child kinds this tool knows how to brief. */\nexport const AGENT_KINDS = [\"poteto-agent\", \"comment-sicko\", \"general\"] as const;\n\nexport type AgentKind = (typeof AGENT_KINDS)[number];\n\n/** One exact route a row may authorize for explicit child selection. */\nexport interface AllowedModelRoute {\n  readonly provider: string;\n  readonly model: string;\n}\n\n/** Row configuration. */\nexport interface PstackSubagentConfig {\n  /** `ctx.subagents` provider to start children on. */\n  readonly provider: string;\n  /**\n   * This row's delegation-depth cap. A call may lower it and may never exceed it.\n   * Omitted means the Host setting decides.\n   */\n  readonly maxDepth?: number;\n  /**\n   * Exact routes this row authorizes. Empty means no explicit route limit. This is\n   * pstack's own check and is unrelated to the native session `allowedModels`\n   * policy, which this plugin does not read.\n   */\n  readonly allowedModels: readonly AllowedModelRoute[];\n  /** Non-empty allowlist; also what makes `agentPreset` appear in the schema. */\n  readonly allowedAgentPresets: readonly string[];\n}\n\nconst DEFAULT_CONFIG: PstackSubagentConfig = {\n  provider: DEFAULT_SUBAGENT_PROVIDER,\n  allowedModels: [],\n  allowedAgentPresets: [],\n};\n\n/** What a call asked for, after argument validation. */\nexport interface DelegationArgs {\n  readonly description: string;\n  readonly prompt: string;\n  readonly agent: AgentKind;\n  readonly role?: string;\n  readonly cwd?: string;\n  readonly agentPreset?: string;\n  readonly maxDepth?: number;\n  readonly roleIndex?: number;\n  /**\n   * Effort for every child this call starts, overriding each role line's value.\n   *\n   * Validated per entry against the model that entry will actually request, so a\n   * panel with one incompatible entry starts nothing rather than half its children.\n   */\n  readonly reasoningEffort?: string;\n}\n\n/** One child this call started. */\nexport interface ChildRecord {\n  readonly childId: string;\n  readonly label: string;\n  readonly agent: string;\n  readonly role: string;\n  readonly route: string;\n  /** The effort this child runs at, when any applies. */\n  readonly effort?: string;\n  readonly maxDepth?: number;\n}\n\nexport interface DelegationResult {\n  readonly kind: \"activation\" | \"activations\";\n  readonly children: readonly ChildRecord[];\n  readonly diagnostics: readonly string[];\n}\n\n/** Raised for a configuration or argument problem, before any child starts. */\nexport class DelegationError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"DelegationError\";\n  }\n}\n\n/** Raised when a child starts but a later entry in the same call fails. */\nexport class PartialDelegationError extends DelegationError {\n  readonly startedChildren: readonly ChildRecord[];\n\n  constructor(message: string, startedChildren: readonly ChildRecord[]) {\n    super(message);\n    this.name = \"PartialDelegationError\";\n    this.startedChildren = startedChildren;\n  }\n}\n\n/** Raised when a required agent preamble is missing or unusable. */\nexport class PreambleError extends DelegationError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"PreambleError\";\n  }\n}\n\n/** The live services and locations one delegation reads. */\nexport interface SubagentRuntime {\n  readonly subagents: SubagentsHost;\n  readonly llm: LlmHost;\n  /**\n   * The Agent registry, used to reach a child this tool just started.\n   *\n   * Optional because a row can be composed without the `agents` service and a\n   * delegation still works there: the children then keep the effort their request\n   * carried and simply cannot change it afterwards. Making it required would turn a\n   * missing service into a row that registers no tool at all.\n   */\n  readonly agents?: AgentsHost;\n  /** `$DSH_HOME`, home of the role file. */\n  readonly dshHome: string;\n  /** Absolute package assets root, home of the agent preambles. */\n  readonly assetsRoot: string;\n}\n\n// ---------------------------------------------------------------------------\n// Row config\n// ---------------------------------------------------------------------------\n\ninterface StandardSchemaIssue {\n  readonly message: string;\n  readonly path?: readonly (string | number)[];\n}\n\ntype StandardSchemaResult =\n  | { readonly value: PstackSubagentConfig; readonly issues?: undefined }\n  | { readonly issues: readonly StandardSchemaIssue[] };\n\nfunction isNonEmptyString(value: unknown): value is string {\n  return typeof value === \"string\" && value.trim() !== \"\";\n}\n\nfunction isNonNegativeSafeInteger(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isSafeInteger(value) && value >= 0;\n}\n\n/**\n * Minimal Standard Schema for this row, so an omitted `config` is valid and a\n * typo fails at load instead of at the first delegation.\n */\nexport const Config = {\n  \"~standard\": {\n    version: 1,\n    vendor: \"dsh-pstack\",\n    validate(value: unknown): StandardSchemaResult {\n      if (value === undefined || value === null) return { value: DEFAULT_CONFIG };\n      if (typeof value !== \"object\" || Array.isArray(value)) {\n        return { issues: [{ message: \"config must be a mapping\" }] };\n      }\n\n      const record = value as Record<string, unknown>;\n      const issues: StandardSchemaIssue[] = [];\n      const allowedKeys = new Set([\n        \"provider\",\n        \"maxDepth\",\n        \"allowedModels\",\n        \"allowedAgentPresets\",\n      ]);\n      for (const key of Object.keys(record)) {\n        if (!allowedKeys.has(key)) issues.push({ message: `unknown field \"${key}\"`, path: [key] });\n      }\n\n      const provider = record[\"provider\"];\n      if (provider !== undefined && !isNonEmptyString(provider)) {\n        issues.push({ message: \"provider must be a non-empty string\", path: [\"provider\"] });\n      }\n\n      const maxDepth = record[\"maxDepth\"];\n      if (maxDepth !== undefined && !isNonNegativeSafeInteger(maxDepth)) {\n        issues.push({\n          message: \"maxDepth must be a non-negative safe integer\",\n          path: [\"maxDepth\"],\n        });\n      }\n\n      const allowedModels = record[\"allowedModels\"];\n      const models: AllowedModelRoute[] = [];\n      if (allowedModels !== undefined) {\n        if (!Array.isArray(allowedModels)) {\n          issues.push({ message: \"allowedModels must be an array\", path: [\"allowedModels\"] });\n        } else {\n          allowedModels.forEach((entry, index) => {\n            if (typeof entry !== \"object\" || entry === null || Array.isArray(entry)) {\n              issues.push({\n                message: \"each allowedModels entry must be a { provider, model } object\",\n                path: [\"allowedModels\", index],\n              });\n              return;\n            }\n            const route = entry as Record<string, unknown>;\n            const routeProvider = route[\"provider\"];\n            const routeModel = route[\"model\"];\n            if (!isNonEmptyString(routeProvider) || !isNonEmptyString(routeModel)) {\n              issues.push({\n                message: \"each allowedModels entry needs a non-empty provider and model\",\n                path: [\"allowedModels\", index],\n              });\n              return;\n            }\n            if (models.some((known) => known.provider === routeProvider && known.model === routeModel)) {\n              issues.push({\n                message: `duplicate allowedModels route \"${routeProvider}/${routeModel}\"`,\n                path: [\"allowedModels\", index],\n              });\n              return;\n            }\n            models.push({ provider: routeProvider, model: routeModel });\n          });\n        }\n      }\n\n      const allowedPresets = record[\"allowedAgentPresets\"];\n      const presets: string[] = [];\n      if (allowedPresets !== undefined) {\n        if (!Array.isArray(allowedPresets)) {\n          issues.push({\n            message: \"allowedAgentPresets must be an array\",\n            path: [\"allowedAgentPresets\"],\n          });\n        } else {\n          allowedPresets.forEach((entry, index) => {\n            if (!isNonEmptyString(entry)) {\n              issues.push({\n                message: \"each allowedAgentPresets entry must be a non-empty string\",\n                path: [\"allowedAgentPresets\", index],\n              });\n              return;\n            }\n            if (presets.includes(entry)) {\n              issues.push({\n                message: `duplicate allowedAgentPresets entry \"${entry}\"`,\n                path: [\"allowedAgentPresets\", index],\n              });\n              return;\n            }\n            presets.push(entry);\n          });\n        }\n      }\n\n      if (issues.length > 0) return { issues };\n      return {\n        value: {\n          provider: isNonEmptyString(provider) ? provider : DEFAULT_SUBAGENT_PROVIDER,\n          ...(isNonNegativeSafeInteger(maxDepth) ? { maxDepth } : {}),\n          allowedModels: models,\n          allowedAgentPresets: presets,\n        },\n      };\n    },\n  },\n};\n\n// ---------------------------------------------------------------------------\n// Preamble\n// ---------------------------------------------------------------------------\n\n/**\n * Read one agent preamble from the package assets by absolute path.\n *\n * A missing or empty preamble blocks that agent type. It never degrades into a\n * plain child, because a `comment-sicko` or `poteto-agent` child without its\n * instructions is a different agent wearing the name.\n */\nexport function loadAgentPreamble(agent: AgentKind, assetsRoot: string): string | undefined {\n  const path = agentPreamblePath(agent);\n  if (path === undefined) return undefined;\n\n  const absolute = join(assetsRoot, \"agents\", `${agent}.md`);\n  let text: string;\n  try {\n    text = readFileSync(absolute, \"utf8\");\n  } catch (error) {\n    const code = (error as { code?: unknown }).code;\n    const detail = typeof code === \"string\" ? code : String(error);\n    throw new PreambleError(\n      `the ${agent} preamble cannot be read at ${absolute} (${detail}). This agent type does not start without its preamble; reinstall dsh-pstack so the packaged assets are present, or pass agent: \"general\" for a plain child that gets no preamble.`,\n    );\n  }\n\n  const body = parseFrontmatter(text).body.trim();\n  if (body === \"\") {\n    throw new PreambleError(\n      `the ${agent} preamble at ${absolute} is empty. This agent type does not start without its instructions; repair the packaged asset or pass agent: \"general\".`,\n    );\n  }\n  return body;\n}\n\n/** One absolute path the Host injects into a child brief. */\nexport interface InjectedPath {\n  readonly label: string;\n  readonly path: string;\n}\n\n/**\n * Compose the self-contained prompt one child receives.\n *\n * The preambles used to locate things themselves; the Host injects the absolute\n * paths instead, so a child never scans a plugin directory or guesses a version.\n */\nexport function composeChildPrompt(input: {\n  readonly preamble?: string;\n  readonly injectedPaths?: readonly InjectedPath[];\n  readonly task: string;\n}): string {\n  const sections: string[] = [];\n  if (input.preamble !== undefined) sections.push(input.preamble);\n\n  const injected = input.injectedPaths ?? [];\n  if (injected.length > 0) {\n    sections.push(\n      [\n        \"Absolute paths injected by `pstack_subagent`. Read them directly; do not search a plugin directory.\",\n        \"\",\n        ...injected.map((entry) => `- ${entry.label}: \\`${entry.path}\\``),\n      ].join(\"\\n\"),\n    );\n  }\n\n  if (sections.length === 0) return input.task;\n  sections.push(`Task:\\n\\n${input.task}`);\n  return sections.join(\"\\n\\n---\\n\\n\");\n}\n\n/** One planned child, before any Host call. */\nexport interface ChildPlan {\n  readonly index: number;\n  readonly total: number;\n  readonly label: string;\n  readonly agent: AgentKind;\n  readonly role: string;\n  readonly route: ChildRoute;\n  readonly routeLabel: string;\n  /** The effort this child will actually run at: the override when present, else the role line's. */\n  readonly effort?: string;\n  readonly agentOptions?: AgentOptions;\n  readonly agentPreset?: string;\n  readonly cwd?: string;\n  readonly maxDepth?: number;\n}\n\n/** The decided plan for one call. */\nexport interface DelegationPlan {\n  readonly agent: AgentKind;\n  readonly prompt: string;\n  readonly provider: string;\n  readonly role: string;\n  readonly mode: RouteSelection[\"mode\"];\n  readonly roleIndex?: number;\n  readonly roleTotal: number;\n  /** The call-wide effort override, when it supplied one. */\n  readonly reasoningEffort?: string;\n  readonly children: readonly ChildPlan[];\n  readonly diagnostics: readonly string[];\n}\n\n// ---------------------------------------------------------------------------\n// Route and depth helpers\n// ---------------------------------------------------------------------------\n\n/** The text form of one route, as reported back to the model. */\nexport function routeLabel(route: ChildRoute): string {\n  if (route.kind === \"inherit\") return \"inherit-parent\";\n  return route.effort === undefined\n    ? `${route.provider}/${route.model}`\n    : `${route.provider}/${route.model} [${route.effort}]`;\n}\n\n/**\n * The route text a caller sees when an effort override wins.\n *\n * `routeLabel` describes the role file, which stops being the whole truth once the\n * caller overrode the effort. Reporting the file's value there would tell the model\n * its override had been ignored.\n */\nexport function plannedRouteLabel(route: ChildRoute, effortOverride?: string): string {\n  const effort = effectiveEffort(route, effortOverride);\n  const base = route.kind === \"inherit\" ? \"inherit-parent\" : `${route.provider}/${route.model}`;\n  return effort === undefined ? base : `${base} [${effort}]`;\n}\n\nexport { agentOptionsFor };\n\n/**\n * Take the smallest of the requested depth, this row's cap, and the Host setting.\n *\n * A request above the row cap is an error rather than a silent clamp, so a caller\n * cannot believe it asked for two levels when the row allows one.\n */\nexport function resolveDelegationDepth(\n  configured: number | undefined,\n  requested: number | undefined,\n  hostLimit: number | undefined,\n): number | undefined {\n  if (requested !== undefined && !isNonNegativeSafeInteger(requested)) {\n    throw new DelegationError(\"maxDepth must be a non-negative safe integer\");\n  }\n  if (configured !== undefined && requested !== undefined && requested > configured) {\n    throw new DelegationError(\n      `maxDepth ${requested} exceeds this row's configured cap of ${configured}. Lower the request or raise \\`pstack-subagent\\` config.maxDepth; this tool never forwards a depth above its own row.`,\n    );\n  }\n\n  const candidates = [configured, requested, hostLimit].filter(\n    (value): value is number => value !== undefined,\n  );\n  return candidates.length === 0 ? undefined : Math.min(...candidates);\n}\n\n// ---------------------------------------------------------------------------\n// Arguments\n// ---------------------------------------------------------------------------\n\n/**\n * Validate the model-facing arguments.\n *\n * The tool schema is advisory at the model boundary, so every constraint is\n * re-checked here and reported with the reason.\n */\nexport function parseDelegationArgs(\n  raw: unknown,\n  config: PstackSubagentConfig = DEFAULT_CONFIG,\n): DelegationArgs {\n  if (typeof raw !== \"object\" || raw === null || Array.isArray(raw)) {\n    throw new DelegationError(\"arguments must be an object\");\n  }\n  const record = raw as Record<string, unknown>;\n\n  const known = new Set([\n    \"description\",\n    \"prompt\",\n    \"agent\",\n    \"role\",\n    \"cwd\",\n    ...(config.allowedAgentPresets.length > 0 ? [\"agentPreset\"] : []),\n    \"maxDepth\",\n    \"roleIndex\",\n    \"reasoningEffort\",\n  ]);\n  for (const key of Object.keys(record)) {\n    if (!known.has(key)) {\n      const hint =\n        key === \"agentPreset\"\n          ? \"agentPreset is only available when this row configures allowedAgentPresets\"\n          : `accepted arguments are ${[...known].join(\", \")}`;\n      throw new DelegationError(`unknown argument \"${key}\": ${hint}`);\n    }\n  }\n\n  const description = record[\"description\"];\n  if (!isNonEmptyString(description)) {\n    throw new DelegationError(\"description must be a non-empty string: it becomes the child label\");\n  }\n  const prompt = record[\"prompt\"];\n  if (!isNonEmptyString(prompt)) {\n    throw new DelegationError(\"prompt must be a non-empty string\");\n  }\n\n  const agentRaw = record[\"agent\"];\n  if (agentRaw !== undefined && typeof agentRaw !== \"string\") {\n    throw new DelegationError(`agent must be a string: ${AGENT_KINDS.join(\", \")}`);\n  }\n  const agent = (agentRaw ?? DEFAULT_AGENT_KIND) as string;\n  if (!(AGENT_KINDS as readonly string[]).includes(agent)) {\n    throw new DelegationError(\n      `unknown agent \"${agent}\". Accepted kinds are ${AGENT_KINDS.join(\", \")}; a pstack agent type is not a DSH agent preset, so \\`agent\\` never accepts a preset id.`,\n    );\n  }\n\n  const role = record[\"role\"];\n  if (role !== undefined && !isNonEmptyString(role)) {\n    throw new DelegationError(\"role must be a non-empty string when present\");\n  }\n\n  const cwd = record[\"cwd\"];\n  if (cwd !== undefined && !isNonEmptyString(cwd)) {\n    throw new DelegationError(\"cwd must be a non-empty string when present\");\n  }\n\n  const agentPreset = record[\"agentPreset\"];\n  if (agentPreset !== undefined) {\n    if (config.allowedAgentPresets.length === 0) {\n      throw new DelegationError(\n        \"agentPreset is not available: this pstack-subagent row configures no allowedAgentPresets\",\n      );\n    }\n    if (!isNonEmptyString(agentPreset) || !config.allowedAgentPresets.includes(agentPreset)) {\n      throw new DelegationError(\n        `agentPreset ${JSON.stringify(agentPreset)} is not in this row's allowlist (${config.allowedAgentPresets.join(\", \")})`,\n      );\n    }\n  }\n\n  const maxDepth = record[\"maxDepth\"];\n  if (maxDepth !== undefined && !isNonNegativeSafeInteger(maxDepth)) {\n    throw new DelegationError(\"maxDepth must be a non-negative safe integer\");\n  }\n\n  const roleIndex = record[\"roleIndex\"];\n  if (roleIndex !== undefined) {\n    if (!isNonNegativeSafeInteger(roleIndex)) {\n      throw new DelegationError(\"roleIndex must be a non-negative safe integer\");\n    }\n    if (role === undefined) {\n      throw new DelegationError(\n        \"roleIndex requires role: it selects one entry of a list-valued role, and without a role there is no list\",\n      );\n    }\n  }\n\n  const requestedEffort = record[\"reasoningEffort\"];\n  if (requestedEffort !== undefined && !isNonEmptyString(requestedEffort)) {\n    throw new DelegationError(\n      \"reasoningEffort must be a non-empty string when present. It is one adapter-owned token, validated against the model this call will actually request; an empty value would silently re-enable the adapter default.\",\n    );\n  }\n  if (typeof requestedEffort === \"string\" && /\\s/.test(requestedEffort.trim())) {\n    throw new DelegationError(\n      `reasoningEffort ${JSON.stringify(requestedEffort)} contains whitespace. An effort is one token, exactly as the model advertises it.`,\n    );\n  }\n\n  return {\n    description,\n    prompt,\n    agent: agent as AgentKind,\n    ...(role === undefined ? {} : { role }),\n    ...(cwd === undefined ? {} : { cwd }),\n    ...(agentPreset === undefined ? {} : { agentPreset }),\n    ...(maxDepth === undefined ? {} : { maxDepth }),\n    ...(roleIndex === undefined ? {} : { roleIndex }),\n    ...(requestedEffort === undefined ? {} : { reasoningEffort: requestedEffort.trim() }),\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Planning\n// ---------------------------------------------------------------------------\n\n/**\n * Resolve the role file, the routes, the prompt, and the depth into one plan.\n *\n * Pure with respect to the Host: it reads the role file and the packaged preamble,\n * and it makes no service call.\n */\nexport function planDelegation(\n  args: DelegationArgs,\n  runtime: SubagentRuntime,\n  config: PstackSubagentConfig = DEFAULT_CONFIG,\n): DelegationPlan {\n  const preamble = loadAgentPreamble(args.agent, runtime.assetsRoot);\n\n  const rolePath = modelsFilePath(runtime.dshHome);\n  const roleFile = readRoleFile(rolePath);\n  if (roleFile.status === \"unreadable\") {\n    throw new DelegationError(\n      `the pstack role file at ${rolePath} exists but cannot be read (${roleFile.reason}). This is a broken configuration, not \"no configuration\": fix its permissions or delete the file, which makes every role inherit the parent route.`,\n    );\n  }\n  const diagnostics: string[] = [];\n  if (roleFile.status === \"loaded\") {\n    for (const issue of roleFile.issues) {\n      diagnostics.push(\n        `${rolePath}${issue.line === undefined ? \"\" : `:${issue.line}`}: ${issue.message}`,\n      );\n    }\n  }\n\n  let selection: RouteSelection | undefined;\n  let roleSpec: RoleSpec | undefined;\n  if (args.role !== undefined) {\n    roleSpec = requireRole(args.role);\n    const entry = roleFile.status === \"loaded\" ? roleFile.roles.get(roleSpec.key) : undefined;\n    selection = selectRoleRoutes(roleSpec, entry, args.roleIndex);\n  }\n\n  const routes: readonly ChildRoute[] = selection?.routes ?? [{ kind: \"inherit\" }];\n  const roleName = roleSpec?.key ?? \"(none)\";\n\n  if (selection !== undefined) {\n    if (!selection.configured) {\n      diagnostics.push(\n        `role \"${selection.role.key}\" has no line in ${rolePath}, so it inherits the parent route. Add a line to route it explicitly.`,\n      );\n    }\n    if (selection.mode === \"selected\") {\n      diagnostics.push(\n        `role \"${selection.role.key}\" holds ${selection.total} entries and is not an automatic panel; entry ${(selection.roleIndex ?? 0) + 1} was selected. Pass \\`roleIndex\\` to choose another.`,\n      );\n    }\n    if (selection.role.key === \"swarm workers\") {\n      diagnostics.push(\n        'role \"swarm workers\" is a list, not a panel: its first entry is the default route for every worker, and `roleIndex` gives one race arm another entry. Each worker still needs its own pstack_subagent call, because this tool cannot compare separate calls.',\n      );\n    }\n  }\n\n  assertAllowedModels(routes, config, roleName);\n\n  const injected: InjectedPath[] =\n    args.agent === \"poteto-agent\"\n      ? [{ label: \"`poteto-mode` SKILL.md\", path: POTETO_MODE_SKILL_PATH }]\n      : [];\n  const prompt = composeChildPrompt({\n    ...(preamble === undefined ? {} : { preamble }),\n    injectedPaths: injected,\n    task: args.prompt,\n  });\n\n  // The Host setting is applied at start time; the plan records the row's own cap.\n  const depth = resolveDelegationDepth(config.maxDepth, args.maxDepth, undefined);\n\n  const total = routes.length;\n  const children: ChildPlan[] = routes.map((route, index) => {\n    const agentOptions = agentOptionsFor(route, args.reasoningEffort);\n    const effort = effectiveEffort(route, args.reasoningEffort);\n    return {\n      index,\n      total,\n      label:\n        total > 1 ? `${args.description} [${roleName} ${index + 1}/${total}]` : args.description,\n      agent: args.agent,\n      role: roleName,\n      route,\n      routeLabel: plannedRouteLabel(route, args.reasoningEffort),\n      ...(effort === undefined ? {} : { effort }),\n      ...(agentOptions === undefined ? {} : { agentOptions }),\n      ...(args.agentPreset === undefined ? {} : { agentPreset: args.agentPreset }),\n      ...(args.cwd === undefined ? {} : { cwd: args.cwd }),\n      ...(depth === undefined ? {} : { maxDepth: depth }),\n    };\n  });\n\n  if (args.reasoningEffort !== undefined) {\n    const overwritten = routes.filter(\n      (route) => route.kind === \"route\" && route.effort !== undefined && route.effort !== args.reasoningEffort,\n    );\n    if (overwritten.length > 0) {\n      diagnostics.push(\n        `reasoningEffort \"${args.reasoningEffort}\" overrides the effort this call's role line names (${overwritten\n          .map((route) => routeLabel(route))\n          .join(\", \")}). The role line is a starting baseline, so this is allowed; pass no reasoningEffort to keep it.`,\n      );\n    }\n  }\n\n  addPanelDiagnostics(children, roleName, selection, rolePath, diagnostics);\n\n  return {\n    agent: args.agent,\n    prompt,\n    provider: config.provider,\n    role: roleName,\n    mode: selection?.mode ?? \"single\",\n    ...(selection?.roleIndex === undefined ? {} : { roleIndex: selection.roleIndex }),\n    roleTotal: selection?.total ?? 1,\n    ...(args.reasoningEffort === undefined ? {} : { reasoningEffort: args.reasoningEffort }),\n    children,\n    diagnostics,\n  };\n}\n\nfunction assertAllowedModels(\n  routes: readonly ChildRoute[],\n  config: PstackSubagentConfig,\n  roleName: string,\n): void {\n  if (config.allowedModels.length === 0) return;\n  const unauthorized = routes.filter(\n    (route) =>\n      route.kind === \"route\" &&\n      !config.allowedModels.some(\n        (allowed) => allowed.provider === route.provider && allowed.model === route.model,\n      ),\n  );\n  if (unauthorized.length === 0) return;\n\n  const allowed = config.allowedModels\n    .map((route) => `${route.provider}/${route.model}`)\n    .join(\", \");\n  throw new DelegationError(\n    `role ${roleName} resolves to ${unauthorized.map(routeLabel).join(\", \")}, which this row's allowedModels does not authorize. Authorized routes: ${allowed}. This is pstack's own row limit and is unrelated to the native session allowedModels policy.`,\n  );\n}\n\nfunction addPanelDiagnostics(\n  children: readonly ChildPlan[],\n  roleName: string,\n  selection: RouteSelection | undefined,\n  rolePath: string,\n  diagnostics: string[],\n): void {\n  if (selection === undefined || selection.mode !== \"panel\") return;\n\n  if (children.length === 1) {\n    diagnostics.push(\n      `panel \"${roleName}\" has one configured entry, so this call started one child and claims no model diversity. Add entries to ${rolePath} for a real panel.`,\n    );\n    return;\n  }\n\n  const distinct = new Set(children.map((child) => child.routeLabel));\n  if (distinct.size > 1) return;\n  diagnostics.push(\n    `all ${children.length} entries of panel \"${roleName}\" resolve to the same route (${[...distinct][0]}), so these children are not a cross-model review. Configure distinct routes in ${rolePath} for a real panel.`,\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Host calls\n// ---------------------------------------------------------------------------\n\n/**\n * Validate every route, and every requested effort, before anything starts.\n *\n * `resolveCallConfig` rejects an unsupported effort and any route the owning\n * adapter does not serve. An inherit-parent entry has no provider/model of its own,\n * so its effort is validated against the parent's live route instead. This does not\n * prove credentials, quota, or a successful model call; only a real child request\n * does.\n *\n * Every entry is checked before the first child starts. A panel whose second entry\n * cannot take the effort therefore starts none of them, which is the only outcome\n * that leaves no half-applied override behind.\n */\nasync function preflightRoutes(\n  llm: LlmHost,\n  parent: Agent,\n  children: readonly ChildPlan[],\n  roleName: string,\n  effortOverride: string | undefined,\n  signal: AbortSignal,\n): Promise<void> {\n  for (const child of children) {\n    if (child.agentOptions === undefined) continue;\n\n    if (child.route.kind === \"inherit\") {\n      // Only reachable with an override: an inherit route with no effort carries no\n      // agentOptions at all and is skipped above.\n      const effort = effortOverride as string;\n      try {\n        await validateEffortFor(llm, undefined, effort, parent, signal);\n      } catch (error) {\n        throw new DelegationError(\n          `role ${roleName} inherits the parent route, and reasoningEffort \"${effort}\" failed preflight there: ${describeError(error)} Omit \\`reasoningEffort\\`, or name a role whose line holds an exact route.`,\n        );\n      }\n      continue;\n    }\n\n    const route = child.route;\n    const callConfig = {\n      provider: route.provider,\n      model: route.model,\n      ...(child.effort === undefined ? {} : { reasoningEffort: child.effort }),\n    };\n    try {\n      await llm.resolveCallConfig(callConfig, signal);\n    } catch (error) {\n      throw new DelegationError(\n        `role ${roleName} resolves to ${child.routeLabel}, which failed route preflight: ${describeError(error)}. ${await effortHint(llm, route, child.effort, signal)}`,\n      );\n    }\n  }\n}\n\nasync function effortHint(\n  llm: LlmHost,\n  route: Extract<ChildRoute, { kind: \"route\" }>,\n  effort: string | undefined,\n  signal: AbortSignal,\n): Promise<string> {\n  if (effort !== undefined) {\n    try {\n      const info = await llm.resolveModelInfo(route.provider, route.model, signal);\n      const efforts = info.reasoning?.efforts.map((entry) => entry.id) ?? [];\n      if (efforts.length > 0) {\n        return `Model ${route.provider}/${route.model} supports these efforts: ${efforts.join(\", \")}.`;\n      }\n      return `Model ${route.provider}/${route.model} advertises no reasoning efforts.`;\n    } catch {\n      return `Fix the route or the effort in ${PSTACK_MODELS_FILENAME}; the configured provider/model pair may not be served by this deployment.`;\n    }\n  }\n  return `Check the route in ${PSTACK_MODELS_FILENAME} against the providers this deployment registers.`;\n}\n\n/** Check the backend can enforce what this call asks for. */\nexport function assertProviderCapabilities(\n  capabilities: SubagentCapabilities,\n  providerName: string,\n  asks: { readonly agentOptions: boolean; readonly agentPreset: boolean; readonly maxDepth: boolean },\n): void {\n  const missing: string[] = [];\n  if (asks.agentOptions && !capabilities.agentOptions) missing.push(\"agentOptions\");\n  if (asks.agentPreset && !capabilities.agentPreset) missing.push(\"agentPreset\");\n  if (asks.maxDepth && !capabilities.depthLimit) missing.push(\"maxDepth\");\n  if (missing.length === 0) return;\n  throw new DelegationError(\n    `subagent provider \"${providerName}\" does not support ${missing.join(\", \")}, so this call cannot be honored. Change the route to \\`inherit-parent\\`, drop the unsupported argument, or configure a backend that supports it; this tool never silently ignores it.`,\n  );\n}\n\n/**\n * Start the planned children.\n *\n * Everything that can be rejected has already been rejected. A failure at entry N\n * keeps children 1..N-1 running and reports their ids, because the runtime owns\n * those activations and this tool cannot roll them back.\n */\nexport async function startPlannedChildren(\n  parent: Agent,\n  plan: DelegationPlan,\n  runtime: SubagentRuntime,\n  config: PstackSubagentConfig,\n  signal: AbortSignal,\n): Promise<DelegationResult> {\n  const provider = runtime.subagents.getProvider(plan.provider);\n  if (provider === undefined) {\n    const available = runtime.subagents.list();\n    throw new DelegationError(\n      `subagent provider \"${plan.provider}\" is not registered; registered providers: ${available.length === 0 ? \"(none)\" : available.join(\", \")}. This pstack-subagent row delegates to \"${plan.provider}\"; compose that backend or change the row's provider.`,\n    );\n  }\n\n  const hostLimit = runtime.subagents.resolveMaxDepth(config.maxDepth);\n  const effectiveDepth = resolveDelegationDepth(\n    config.maxDepth,\n    plan.children[0]?.maxDepth,\n    hostLimit,\n  );\n\n  assertProviderCapabilities(provider.capabilities, plan.provider, {\n    agentOptions: plan.children.some((child) => child.agentOptions !== undefined),\n    agentPreset: plan.children.some((child) => child.agentPreset !== undefined),\n    maxDepth: effectiveDepth !== undefined,\n  });\n  const children = plan.children.map((child) => ({\n    ...child,\n    ...(effectiveDepth === undefined ? {} : { maxDepth: effectiveDepth }),\n  }));\n\n  await preflightRoutes(runtime.llm, parent, children, plan.role, plan.reasoningEffort, signal);\n  if (runtime.subagents.getProvider(plan.provider) !== provider) {\n    throw new DelegationError(\n      `subagent provider \"${plan.provider}\" changed while the child routes were being resolved; retry the delegation`,\n    );\n  }\n\n  const started: ChildRecord[] = [];\n  const diagnostics = [...plan.diagnostics];\n  for (const child of children) {\n    signal.throwIfAborted();\n    try {\n      const activation = await runtime.subagents.startActivation({\n        provider: plan.provider,\n        label: child.label,\n        request: {\n          prompt: [{ type: \"text\", text: plan.prompt }] satisfies TextBlock[],\n          parent,\n          ...(child.cwd === undefined ? {} : { cwd: child.cwd }),\n          ...(child.agentPreset === undefined ? {} : { agentPreset: child.agentPreset }),\n          ...(child.agentOptions === undefined ? {} : { agentOptions: child.agentOptions }),\n          ...(child.maxDepth === undefined ? {} : { maxDepth: child.maxDepth }),\n        },\n        signal,\n        delivery: \"parent\",\n      });\n\n      // The child can raise or lower its own effort from here on. Registration is on\n      // the child's own scope, which disposes it with the child, so this call site\n      // keeps no handle: a tool call that returns is not the owner of a child that\n      // keeps running.\n      //\n      // A missing handle is not a failed delegation. The child then runs at the\n      // effort the request carried and cannot change it, which is what a backend\n      // without a live local Agent offers; saying so is better than implying a control\n      // that is not there.\n      const target =\n        runtime.agents === undefined ? undefined : runtime.agents.get(activation.childId);\n      if (target === undefined) {\n        diagnostics.push(\n          `child ${activation.childId} has no live local Agent handle, so it cannot change its own reasoning effort with \\`${SET_EFFORT_TOOL}\\`. It runs at ${child.effort === undefined ? \"the adapter default\" : `\"${child.effort}\"`} for its whole life.`,\n        );\n      } else {\n        installEffortControl(target, runtime.llm, child.effort);\n      }\n\n      started.push({\n        childId: activation.childId,\n        label: child.label,\n        agent: child.agent,\n        role: child.role,\n        route: child.routeLabel,\n        ...(child.effort === undefined ? {} : { effort: child.effort }),\n        ...(child.maxDepth === undefined ? {} : { maxDepth: child.maxDepth }),\n      });\n    } catch (error) {\n      if (started.length === 0) {\n        throw new DelegationError(\n          `starting the ${plan.role === \"(none)\" ? \"child\" : `\"${plan.role}\" child`} \"${child.label}\" (${child.routeLabel}) failed: ${describeError(error)}`,\n        );\n      }\n      throw new PartialDelegationError(\n        `starting entry ${child.index + 1} of ${child.total} for role \"${plan.role}\" (${child.label}, ${child.routeLabel}) failed: ${describeError(error)}. The ${started.length} already started: ${started\n          .map((record) => `${record.childId} (${record.label})`)\n          .join(\", \")}. Those children are still running and are not rolled back; do not start them again, and use list_agents or send_message to reach them.`,\n        started,\n      );\n    }\n  }\n\n  return {\n    kind: started.length === 1 ? \"activation\" : \"activations\",\n    children: started,\n    diagnostics,\n  };\n}\n\n/** Full delegation: plan, validate, start. */\nexport async function delegate(\n  parent: Agent,\n  args: DelegationArgs,\n  runtime: SubagentRuntime,\n  config: PstackSubagentConfig = DEFAULT_CONFIG,\n  signal: AbortSignal = new AbortController().signal,\n): Promise<DelegationResult> {\n  const plan = planDelegation(args, runtime, config);\n  return startPlannedChildren(parent, plan, runtime, config, signal);\n}\n\n// ---------------------------------------------------------------------------\n// Tool\n// ---------------------------------------------------------------------------\n\nconst TOOL_DESCRIPTION = [\n  \"Delegate self-contained work to one or more fresh child agents.\",\n  \"\",\n  \"Returns the id of every child it started plus the route each one resolved. The children run\",\n  \"in the background: their results arrive later as completion notices in this conversation.\",\n  \"Never wait or poll for them, and keep working on something useful meanwhile.\",\n  \"\",\n  \"`agent` picks the brief: `poteto-agent` (default) injects the poteto subagent preamble and\",\n  \"the absolute path of the poteto-mode instructions; `comment-sicko` injects the comment\",\n  \"reviewer persona and must be briefed read-only; `general` is a plain child with no preamble.\",\n  \"\",\n  \"`role` selects a configured pstack role and therefore the child's model route and reasoning\",\n  \"effort. The role names and the meaning of each are in the pstack role manifest, not here.\",\n  \"Omit `role` to inherit the parent route. Panel roles start one child per configured entry.\",\n  \"\",\n  \"`reasoningEffort` raises or lowers the effort for this delegation alone. The role line is a\",\n  \"starting baseline, not a verdict: start from it, raise it for hard work and lower it for\",\n  \"routine work. The value must be one the target model advertises, and this package does not\",\n  \"assume a ladder, so read the effort list the role's model reports rather than guessing. An\",\n  \"unsupported value fails the call before any child starts, including every entry of a panel.\",\n  \"\",\n  \"A running child can also change its own effort with `set_reasoning_effort`, which applies\",\n  \"from its next step. You do not have to predict the level up front.\",\n  \"\",\n  \"Every prompt is a fresh child that does not see this conversation, so include everything it\",\n  \"needs. A child's own summary is not evidence: review its diff or artifacts yourself.\",\n].join(\"\\n\");\n\nfunction buildParameters(config: PstackSubagentConfig): Record<string, unknown> {\n  const properties: Record<string, unknown> = {\n    description: {\n      type: \"string\",\n      description: \"A short 3-5 word label for the child, shown in list_agents and its notices.\",\n    },\n    prompt: {\n      type: \"string\",\n      description:\n        \"The complete, self-contained brief. The child does not see this conversation, so include the task, every prior directive, and the paths or branches it needs.\",\n    },\n    agent: {\n      type: \"string\",\n      enum: [...AGENT_KINDS],\n      description:\n        'Child brief type: \"poteto-agent\" (default) for pstack implementation delegates, \"comment-sicko\" for the read-only comment reviewer, \"general\" for a plain child with no preamble.',\n    },\n    role: {\n      type: \"string\",\n      description:\n        \"A pstack role key, matched exactly. It selects the child's model route and effort. Omit it to inherit the parent route.\",\n    },\n    cwd: {\n      type: \"string\",\n      description:\n        \"The child's initial working directory. Relative paths resolve against this session's directory. Omitted inherits it.\",\n    },\n    maxDepth: {\n      type: \"integer\",\n      description:\n        \"How many further delegation levels the child may use; 0 or greater, and negative values are rejected. It can only lower this row's configured cap, never raise it.\",\n    },\n    roleIndex: {\n      type: \"integer\",\n      description:\n        \"Selects one entry of a list-valued role that is not an automatic panel; 0 or greater, and negative values are rejected. Requires `role`.\",\n    },\n    reasoningEffort: {\n      type: \"string\",\n      description: [\n        \"Reasoning effort for every child this call starts, overriding the role line's value for this delegation.\",\n        \"Start from the role's level, raise it for hard work, lower it for routine work.\",\n        \"The value must be one the target model advertises: this package assumes no ladder and rejects an unknown token with that model's real effort list.\",\n        \"It is validated for every panel entry before any child starts, so one incompatible entry fails the whole call instead of half-starting it.\",\n        \"Omit it to use the role line's effort.\",\n      ].join(\" \"),\n    },\n  };\n\n  if (config.allowedAgentPresets.length > 0) {\n    properties[\"agentPreset\"] = {\n      type: \"string\",\n      enum: [...config.allowedAgentPresets],\n      description: \"An independent child preset from this row's allowlist.\",\n    };\n  }\n\n  return {\n    type: \"object\",\n    additionalProperties: false,\n    properties,\n    required: [\"description\", \"prompt\"],\n  };\n}\n\nexport const OUTPUT_SCHEMA: JsonSchemaNode = {\n  type: \"object\",\n  additionalProperties: false,\n  properties: {\n    kind: {\n      type: \"string\",\n      enum: [\"activation\", \"activations\"],\n      description: \"How many children this call started.\",\n    },\n    children: {\n      type: \"array\",\n      description: \"One record per started child, in start order.\",\n      items: {\n        type: \"object\",\n        additionalProperties: false,\n        properties: {\n          childId: { type: \"string\", description: \"The child session id.\" },\n          label: { type: \"string\", description: \"The label this call gave the child.\" },\n          agent: { type: \"string\", description: \"The child brief type.\" },\n          role: { type: \"string\", description: \"The role key, or `(none)`.\" },\n          route: {\n            type: \"string\",\n            description: \"`inherit-parent` or `<provider>/<model> [effort]`.\",\n          },\n          effort: {\n            type: \"string\",\n            description:\n              \"The reasoning effort this child runs at, when one applies. Equal to the call's `reasoningEffort` when that was passed.\",\n          },\n          maxDepth: {\n            type: \"integer\",\n            description: \"The delegation-depth cap the child received.\",\n          },\n        },\n        required: [\"childId\", \"label\", \"agent\", \"role\", \"route\"],\n      },\n    },\n    diagnostics: {\n      type: \"array\",\n      description:\n        \"Configuration notes, including a panel whose entries share one route. Empty when nothing needs reporting.\",\n      items: { type: \"string\" },\n    },\n  },\n  required: [\"kind\", \"children\", \"diagnostics\"],\n};\n\n/** Render one delegation result for the model. */\nexport function renderDelegationResult(result: DelegationResult): string {\n  const lines = [\n    result.kind === \"activation\"\n      ? `started 1 child: ${result.children[0]?.childId ?? \"(none)\"}`\n      : `started ${result.children.length} children:`,\n    ...result.children.map(\n      (child) =>\n        `- ${child.childId} (${child.label}) agent=${child.agent} role=${child.role} route=${child.route}${child.effort === undefined ? \"\" : ` effort=${child.effort}`}${child.maxDepth === undefined ? \"\" : ` maxDepth=${child.maxDepth}`}`,\n    ),\n    \"Results arrive as completion notices; do not poll for them. Each child can change its own\",\n    \"effort from its next step with `set_reasoning_effort`; you do not need to predict it up front.\",\n  ];\n  if (result.diagnostics.length > 0) {\n    lines.push(\n      \"\",\n      \"Diagnostics:\",\n      ...result.diagnostics.map((diagnostic) => `- ${diagnostic}`),\n    );\n  }\n  return lines.join(\"\\n\");\n}\n\n/** Build the model-facing tool for one row. */\nexport function createPstackSubagentTool(\n  runtime: SubagentRuntime,\n  config: PstackSubagentConfig = DEFAULT_CONFIG,\n): ToolDefinition {\n  return {\n    name: TOOL_NAME,\n    description: TOOL_DESCRIPTION,\n    parameters: buildParameters(config),\n    output: {\n      schema: OUTPUT_SCHEMA,\n      render: (_args, value) => [\n        { type: \"text\", text: renderDelegationResult(value as DelegationResult) },\n      ],\n    },\n    isConcurrencySafe: () => true,\n    async execute(rawArgs, exec: ToolRunContext) {\n      const parent = exec.agent;\n      if (parent === undefined) {\n        throw new DelegationError(\n          \"pstack_subagent needs a calling Agent, and exec.agent was undefined. This tool runs inside a conversation; it cannot start a child from a context that has no parent Agent.\",\n        );\n      }\n      const args = parseDelegationArgs(rawArgs, config);\n      const result = await delegate(parent, args, runtime, config, exec.signal);\n      return result;\n    },\n  };\n}\n\n/**\n * The slices of the Cordis context this row uses.\n *\n * `agents` is optional in both directions: it is absent from `inject` and read per\n * call below, so a profile that mounts no agent registry still registers this tool.\n * See the `inject` comment for why a hard dependency is the wrong shape here.\n */\nexport interface PstackSubagentHost {\n  readonly tools: ToolsHost;\n  readonly subagents: SubagentsHost;\n  readonly llm: LlmHost;\n}\n\n/** Build the runtime a real Host call reads. */\nexport function hostRuntime(\n  ctx: PstackSubagentHost,\n  getAgentRegistry: () => AgentsHost | undefined = () => undefined,\n): SubagentRuntime {\n  return {\n    subagents: ctx.subagents,\n    llm: ctx.llm,\n    // Resolved per delegation, not snapshotted: `agents` may mount after this row.\n    get agents() {\n      return getAgentRegistry();\n    },\n    dshHome: resolveDshHome(),\n    assetsRoot: ASSETS_ROOT,\n  };\n}\n\n/**\n * Register `pstack_subagent` for this row.\n *\n * @param ctx - context providing the tool registry, the subagent registry, the LLM\n *   adapters, and optionally `ctx.get` for the agent registry.\n * @param config - validated row config.\n */\nexport function apply(\n  ctx: PstackSubagentHost & { get?: (name: string) => AgentsHost | undefined },\n  config: PstackSubagentConfig = DEFAULT_CONFIG,\n): void {\n  const runtime = hostRuntime(ctx, () => ctx.get?.(\"agents\"));\n  const tool = createPstackSubagentTool(runtime, config);\n  ctx.tools.register(tool);\n}\n\nfunction describeError(error: unknown): string {\n  if (error instanceof Error) {\n    const code = (error as { code?: unknown }).code;\n    const suffix = typeof code === \"string\" ? ` (${code})` : \"\";\n    return `${error.message}${suffix}`;\n  }\n  return String(error);\n}\n"],"mappings":"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"}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "pstack skills",
+    "description": "Ships the 55 pstack workflow skills inside this package: the model can load setup-pstack, and the other skills are invoked explicitly with /name."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "pstack 技能",
+    "description": "在本包内提供 55 个 pstack 工作流技能：模型可加载 setup-pstack，其余技能用 /name 显式调用。"
+  }
+}

package/package.json

@@ -1,16 +1,12 @@
 {
   "name": "dsh-pstack",
-  "version": "0.1.0",
+  "version": "0.2.0-beta.1",
   "description": "pstack for DeepSeek Harness: rigorous agent workflows ported from cursor/plugins.",
-  "author": {
-    "name": "leiwang",
-    "email": "leiwang2000@foxmail.com"
-  },
   "repository": {
     "type": "git",
-    "url": "https://github.com/l246804/dsh-pstack"
+    "url": "git+https://github.com/l246804/dsh-pstack.git"
   },
-  "homepage": "https://github.com/l246804/dsh-pstack",
+  "homepage": "https://github.com/l246804/dsh-pstack#readme",
   "bugs": {
     "url": "https://github.com/l246804/dsh-pstack/issues"
   },
@@ -23,15 +19,13 @@
     "pstack",
     "workflow"
   ],
+  "author": {
+    "name": "leiwang",
+    "email": "leiwang2000@foxmail.com"
+  },
   "license": "MIT",
-  "files": [
-    "dist",
-    "assets",
-    "cordis.patch.yml",
-    "README.md",
-    "LICENSE"
-  ],
   "type": "module",
+  "icon": "./static/icon.png",
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
   "exports": {
@@ -43,53 +37,73 @@
       "types": "./dist/subagent.d.mts",
       "default": "./dist/subagent.mjs"
     },
+    "./history": {
+      "types": "./dist/history.d.mts",
+      "default": "./dist/history.mjs"
+    },
+    "./script": {
+      "types": "./dist/script.d.mts",
+      "default": "./dist/script.mjs"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./static/icon.png",
     "./package.json": "./package.json"
   },
+  "files": [
+    "dist",
+    "assets",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "static",
+    "README.md",
+    "LICENSE"
+  ],
+  "dsh": {
+    "manifestVersion": 1,
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
   "devDependencies": {
-    "@deepseek-ai/cordis": "~4.0.5",
-    "@deepseek-ai/dsh-agent": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-llm": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-skill": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-subagent": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-tools": "0.2.1-rc.2",
+    "@deepseek-ai/cordis-plugin-include": "~1.0.10",
+    "@deepseek-ai/cordis-plugin-loader": "~1.0.6",
+    "@deepseek-ai/dsh-tools": "0.2.1-rc.3",
+    "@types/js-yaml": "^4.0.9",
     "@types/node": "^26.6.5",
     "bumpp": "^12.3.0",
+    "js-yaml": "^4.3.2",
     "typescript": "^7.0.2",
     "vite-plus": "1.3.0"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "~4.0.5",
-    "@deepseek-ai/dsh-agent": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-llm": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-skill": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-subagent": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-tools": "0.2.1-rc.2"
+    "@deepseek-ai/cordis": "~4.0.5"
   },
   "devEngines": {
     "packageManager": {
       "name": "pnpm",
-      "version": "12.14.0",
+      "version": "12.15.0",
       "onFail": "download"
     }
   },
   "engines": {
-    "dsh": ">=0.2.0 <0.3.0",
-    "node": ">=22.19"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "manifestVersion": 1
+    "node": ">=22.19",
+    "dsh": "0.2.1-rc.3"
   },
   "scripts": {
-    "sync": "node scripts/sync-upstream.ts",
-    "sync:check": "node scripts/check-rewrites.ts --check && node scripts/sync-upstream.ts --check && node scripts/report-coverage.ts --check",
-    "sync:report": "node scripts/report-coverage.ts",
-    "build": "vp pack",
-    "dev": "vp pack --watch",
+    "build:runtime": "node scripts/build-runtime.ts",
+    "build:assets": "pnpm run build:runtime && node scripts/sync-upstream.ts",
+    "build:bundle": "vp pack",
+    "build": "pnpm run build:assets && pnpm run build:bundle",
+    "dev": "pnpm run build:assets && vp pack --watch",
+    "check:upstream": "node scripts/check-upstream-tree.mjs",
+    "check:runtime": "node scripts/build-runtime.ts --check",
+    "check:assets": "pnpm run check:runtime && node scripts/sync-upstream.ts --check && node scripts/check-assets.ts",
+    "check:scripts": "node scripts/check-scripts.ts",
+    "check:pack": "node scripts/check-pack.ts",
+    "typecheck": "tsc --noEmit",
     "test": "vp test",
-    "check": "vp check",
+    "check": "pnpm run check:upstream && pnpm run check:assets && pnpm run check:scripts && pnpm run typecheck && pnpm run test",
     "release": "bumpp"
   }
 }

package/assets/skills/poteto-mode/scripts/bootstrap.ts

@@ -1,62 +0,0 @@
-import { createHash } from "node:crypto";
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-
-const scriptsDirectory = import.meta.dir;
-const nodeModulesDirectory = join(scriptsDirectory, "node_modules");
-const commanderPackagePath = join(
-  nodeModulesDirectory,
-  "commander",
-  "package.json"
-);
-const installKeyPath = join(
-  nodeModulesDirectory,
-  ".poteto-mode-tools-install-key"
-);
-
-function currentInstallKey(): string {
-  return createHash("sha256")
-    .update(readFileSync(join(scriptsDirectory, "package.json")))
-    .update("\0")
-    .update(readFileSync(join(scriptsDirectory, "bun.lock")))
-    .digest("hex");
-}
-
-export function ensureDependenciesInstalled(): void {
-  const installKey = currentInstallKey();
-  if (
-    existsSync(commanderPackagePath) &&
-    existsSync(installKeyPath) &&
-    readFileSync(installKeyPath, "utf8").trim() === installKey
-  ) {
-    return;
-  }
-
-  const result = Bun.spawnSync(
-    [process.execPath, "install", "--frozen-lockfile"],
-    { cwd: scriptsDirectory }
-  );
-  if (result.exitCode !== 0) {
-    process.stdout.write(result.stdout);
-    process.stderr.write(result.stderr);
-    throw new Error(
-      `bun install --frozen-lockfile exited with status ${result.exitCode}`
-    );
-  }
-  if (!existsSync(commanderPackagePath)) {
-    throw new Error(
-      "bun install --frozen-lockfile completed without installing commander"
-    );
-  }
-
-  writeFileSync(installKeyPath, `${installKey}\n`);
-
-  const restarted = Bun.spawnSync([process.execPath, ...process.argv.slice(1)], {
-    cwd: process.cwd(),
-    env: process.env,
-    stdin: "inherit",
-    stdout: "inherit",
-    stderr: "inherit",
-  });
-  process.exit(restarted.exitCode ?? 1);
-}