thoth-agents 0.2.9 → 0.2.11

package/dist/{chunk-YLRPDTU7.js → chunk-OZE7JVGS.js}

@@ -425,7 +425,27 @@ function writeConfig(configPath, config) {
   writeFileSync(tmpPath, content);
   renameSync(tmpPath, configPath);
 }
-async function addPluginToOpenCodeConfig() {
+function mergeOpenCodeMainConfig(config, update) {
+  if (update.ensurePlugin) {
+    const plugins = Array.isArray(config.plugin) ? config.plugin : [];
+    config.plugin = [
+      ...plugins.filter(
+        (plugin) => plugin !== PACKAGE_NAME && !plugin.startsWith(`${PACKAGE_NAME}@`)
+      ),
+      `${PACKAGE_NAME}@latest`
+    ];
+  }
+  if (update.disableDefaults) {
+    const agent = config.agent && typeof config.agent === "object" ? { ...config.agent } : {};
+    const explore = agent.explore && typeof agent.explore === "object" ? { ...agent.explore } : {};
+    const general = agent.general && typeof agent.general === "object" ? { ...agent.general } : {};
+    agent.explore = { ...explore, disable: true };
+    agent.general = { ...general, disable: true };
+    config.agent = agent;
+  }
+  return config;
+}
+function updateOpenCodeMainConfig(update) {
   const configPath = getExistingConfigPath();
   try {
     ensureOpenCodeConfigDir();
@@ -445,14 +465,10 @@ async function addPluginToOpenCodeConfig() {
         error: `Failed to parse config: ${error}`
       };
     }
-    const config = parsedConfig ?? {};
-    const plugins = config.plugin ?? [];
-    const filteredPlugins = plugins.filter(
-      (p) => p !== PACKAGE_NAME && !p.startsWith(`${PACKAGE_NAME}@`)
+    writeConfig(
+      configPath,
+      mergeOpenCodeMainConfig(parsedConfig ?? {}, update)
     );
-    filteredPlugins.push(`${PACKAGE_NAME}@latest`);
-    config.plugin = filteredPlugins;
-    writeConfig(configPath, config);
     return { success: true, configPath };
   } catch (err) {
     return {
@@ -485,33 +501,6 @@ function writeLiteConfig(installConfig, targetPath) {
     };
   }
 }
-function disableDefaultAgents() {
-  const configPath = getExistingConfigPath();
-  try {
-    ensureOpenCodeConfigDir();
-    const { config: parsedConfig, error } = parseConfig(configPath);
-    if (error) {
-      return {
-        success: false,
-        configPath,
-        error: `Failed to parse config: ${error}`
-      };
-    }
-    const config = parsedConfig ?? {};
-    const agent = config.agent ?? {};
-    agent.explore = { disable: true };
-    agent.general = { disable: true };
-    config.agent = agent;
-    writeConfig(configPath, config);
-    return { success: true, configPath };
-  } catch (err) {
-    return {
-      success: false,
-      configPath,
-      error: `Failed to disable default agents: ${err}`
-    };
-  }
-}
 function detectCurrentConfig() {
   const result = {
     isInstalled: false,
@@ -710,8 +699,8 @@ var OPENCODE_CAPABILITIES = {
 };
 var CODEX_PROMPT_CAPABILITIES = {
   agentDefinitions: "supported",
-  delegatedExecution: "instruction-only",
-  parallelDelegation: "instruction-only",
+  delegatedExecution: "supported",
+  parallelDelegation: "supported",
   runtimeHooks: "unknown",
   mcpConfiguration: "supported",
   skillPackaging: "supported",
@@ -755,6 +744,13 @@ var OPENCODE_PROMPT_DIALECT = {
     userQuestionTool: "question",
     progressTool: "todowrite",
     hostStatusSurface: "task_status",
+    lifecycle: {
+      statusAction: "wait, poll, and collect",
+      terminalState: "terminal task_status result",
+      nonterminalState: "nonterminal task_status result",
+      sameSessionProbe: "task_status on the same task session",
+      enforcement: "runtime-supported"
+    },
     roleReference: (role) => `@${role}`
   },
   capabilities: supportedCapabilityProfile(OPENCODE_CAPABILITIES),
@@ -775,12 +771,19 @@ var OPENCODE_PROMPT_DIALECT = {
 var CODEX_PROMPT_DIALECT = {
   harness: "codex",
   tools: {
-    delegationTool: "multi_agent_v1.spawn_agent",
-    backgroundDelegationTool: "multi_agent_v1.spawn_agent",
-    backgroundStatusTool: "multi_agent_v1.wait_agent",
+    delegationTool: "collaboration.spawn_agent",
+    backgroundDelegationTool: "collaboration.spawn_agent",
+    backgroundStatusTool: "collaboration.wait_agent",
     userQuestionTool: "request_user_input",
     progressTool: "functions.update_plan",
-    hostStatusSurface: "multi_agent_v1.wait_agent",
+    hostStatusSurface: "collaboration.list_agents",
+    lifecycle: {
+      statusAction: "wait and inspect status",
+      terminalState: "terminal mailbox completion or failure update",
+      nonterminalState: "collaboration.wait_agent timeout or silence",
+      sameSessionProbe: "collaboration.list_agents on the same task path",
+      enforcement: "runtime-supported"
+    },
     roleReference: (role) => `${role} role agent`
   },
   capabilities: {
@@ -792,9 +795,9 @@ var CODEX_PROMPT_DIALECT = {
       case "root-coordinator":
         return "ambient Codex root session coordinator";
       case "task":
-        return "multi_agent_v1.spawn_agent";
+        return "collaboration.spawn_agent";
       case "synchronous-task-only":
-        return "synchronous multi_agent_v1.spawn_agent only";
+        return "synchronous collaboration.spawn_agent only";
     }
   },
   renderRoleInvocation(role) {
@@ -814,6 +817,13 @@ var CLAUDE_CODE_PROMPT_DIALECT = {
     userQuestionTool: "AskUserQuestion",
     progressTool: "TodoWrite",
     hostStatusSurface: "TodoWrite",
+    lifecycle: {
+      statusAction: "wait, poll, and collect",
+      terminalState: "terminal TaskOutput result",
+      nonterminalState: "nonterminal TaskOutput result",
+      sameSessionProbe: "TaskOutput on the same task session",
+      enforcement: "runtime-supported"
+    },
     roleReference: (role) => role === "orchestrator" ? "the main-thread orchestrator" : `Task(subagent_type: ${claudeCodeSubagentType(role)})`
   },
   capabilities: supportedCapabilityProfile(CLAUDE_CODE_PROMPT_CAPABILITIES),
@@ -943,6 +953,7 @@ var SDD_PHASES = [
     artifactSkill: "sdd-tasks",
     defaultAgentRole: "quick",
     alternateAgentRoles: ["deep"],
+    alternateAgentCondition: "Only when the task plan is complex.",
     delegationReason: "Mechanical conversion of settled design into dependency-ordered execution tasks."
   },
   {
@@ -1131,6 +1142,10 @@ function alternateSddRoles(id) {
   const phase = getDelegatedSddPhase(id);
   return phase.alternateAgentRoles?.length ? renderRoleList(phase.alternateAgentRoles) : "";
 }
+function alternateSddCondition(id) {
+  const condition = getDelegatedSddPhase(id).alternateAgentCondition;
+  return condition ? condition.replace(/^Only/, "only").replace(/\.$/, "") : "";
+}
 function supportSddRoles(id) {
   const phase = getDelegatedSddPhase(id);
   return phase.supportingAgentRoles?.length ? renderRoleList(phase.supportingAgentRoles) : "";
@@ -1142,7 +1157,7 @@ function persistenceSddRole(id) {
 function renderSddDelegationMatrix() {
   return `<sdd-delegation-matrix>
 - sdd-init -> ${primarySddRole("init")} (+${supportSddRoles("init")}, if openspec/ missing); sdd-explore -> ${primarySddRole("explore")} (+${supportSddRoles("explore")})
-- sdd-propose/sdd-spec/sdd-design -> ${primarySddRole("proposal")}; sdd-clarify -> ${primarySddRole("clarify")}; sdd-tasks -> ${primarySddRole("tasks")} (fallback: ${alternateSddRoles("tasks")})
+- sdd-propose/sdd-spec/sdd-design -> ${primarySddRole("proposal")}; sdd-clarify -> ${primarySddRole("clarify")}; sdd-tasks -> ${primarySddRole("tasks")} (fallback: ${alternateSddRoles("tasks")} ${alternateSddCondition("tasks")})
 - plan-reviewer -> ${primarySddRole("plan-review")}; sdd-apply -> ${primarySddRole("apply")} (fallback: ${alternateSddRoles("apply")}); sdd-verify -> ${primarySddRole("verify")} (persistence: ${persistenceSddRole("verify")}); sdd-archive -> ${primarySddRole("archive")}
 </sdd-delegation-matrix>`;
 }
@@ -1280,11 +1295,9 @@ For {{role.explorer}}/{{role.librarian}}, ask narrow fact-finding questions for
 - Experimental background \`{{backgroundDelegationTool}}\` is allowed only for {{role.explorer}} and {{role.librarian}} for asynchronous delegation.
 - {{role.oracle}}, {{role.designer}}, {{role.quick}}, and {{role.deep}} always use normal synchronous \`{{delegationTool}}\` execution.
 - When using background \`{{delegationTool}}\`, treat it as conditional and non-portable: if the host does not expose the experimental path, fall back to normal synchronous \`{{delegationTool}}\`.
-- Use \`{{backgroundStatusTool}}\` to wait, poll, and collect background task results before synthesizing or reporting completion.
-- If a result is empty, contradictory, or low-confidence, retry once with a materially sharper prompt; then escalate with evidence via \`{{userQuestionTool}}\`.
-- If a named subagent hits capacity, retry that same role up to 3 attempts.
-- Never switch to \`default\`, \`worker\`, or any other role.
-- After 3 failures, stay on the same role; if a same-role model override exists, use it. Otherwise report a capacity blocker.
+- Use \`{{backgroundStatusTool}}\` to {{lifecycleStatusAction}}: treat \`{{lifecycleNonterminalState}}\` as in progress and probe the same session via \`{{lifecycleSameSessionProbe}}\`; no retry/reroute/interruption before \`{{lifecycleTerminalState}}\`, an explicit user deadline, user cancellation, or a superseding request.
+- Terminal result-quality and required-artifact checks share one sharpened retry; nonterminal probes use none.
+- Capacity is separate: retry the named role up to 3 times; never switch to \`default\`, \`worker\`, or another role; then use a same-role model override or report a blocker.
 - Write-capable dispatches must include task instructions and handoff retrieval instructions when a root-owned handoff summary exists, so implementers can recover context without rediscovering settled scope.
 - Never tell sub-agents to discard working-tree changes.
 </dispatch>
@@ -1311,7 +1324,6 @@ Hard gates:
 - Group consecutive ready SDD tasks for the same execution agent into one dispatch when dependencies, scope, and verification can be handled together. Keep per-task tracking and evidence; do not split a compatible {{role.designer}}/{{role.quick}}/{{role.deep}} run into one delegation per checkbox.
 
 SDD dispatch envelope must include: skill name, persistence mode, pipeline type, change name, project name, needed prior artifact context, verification expectation, and return envelope.
-After each phase, verify the sub-agent reported the openspec path and/or thoth-mem topic_key. Retry once if missing.
 
 Artifact governance handoff:
 - After \`sdd-tasks\`, you may surface report-only artifact governance findings before execution preparation starts.
@@ -1614,7 +1626,19 @@ function renderRoleText(section, dialect) {
   ).replaceAll(
     "{{backgroundStatusTool}}",
     dialect.tools.backgroundStatusTool ?? dialect.tools.hostStatusSurface ?? ""
-  ).replaceAll("{{userQuestionTool}}", dialect.tools.userQuestionTool).replaceAll("{{progressTool}}", dialect.tools.progressTool).replaceAll("{{dispatch.task}}", dialect.dispatchLabel("task")).replaceAll(
+  ).replaceAll("{{userQuestionTool}}", dialect.tools.userQuestionTool).replaceAll("{{progressTool}}", dialect.tools.progressTool).replaceAll(
+    "{{lifecycleStatusAction}}",
+    dialect.tools.lifecycle.statusAction
+  ).replaceAll(
+    "{{lifecycleTerminalState}}",
+    dialect.tools.lifecycle.terminalState
+  ).replaceAll(
+    "{{lifecycleNonterminalState}}",
+    dialect.tools.lifecycle.nonterminalState
+  ).replaceAll(
+    "{{lifecycleSameSessionProbe}}",
+    dialect.tools.lifecycle.sameSessionProbe
+  ).replaceAll("{{dispatch.task}}", dialect.dispatchLabel("task")).replaceAll(
     "{{dispatch.synchronous-task-only}}",
     dialect.dispatchLabel("synchronous-task-only")
   ).replace(
@@ -2079,6 +2103,9 @@ function resolvePackageRoot(packageRoot) {
   const moduleDir = fileURLToPath(new URL(".", import.meta.url));
   return findPackageRoot(moduleDir) ?? fileURLToPath(new URL("../..", import.meta.url));
 }
+function checkCustomSkillsNeedUpdate(packageRoot) {
+  return checkSkillsNeedUpdate(resolvePackageRoot(packageRoot));
+}
 function installCustomSkillFiles(skill, packageRoot) {
   const sourcePath = join4(packageRoot, skill.sourcePath);
   const targetPath = join4(getCustomSkillsDir(), skill.name);
@@ -2275,14 +2302,12 @@ export {
   getExistingLiteConfigPath,
   getExistingConfigPath,
   ensureConfigDir,
-  ensureOpenCodeConfigDir,
   generateLiteConfig,
   stripJsonComments,
   parseConfig,
   writeConfig,
-  addPluginToOpenCodeConfig,
+  updateOpenCodeMainConfig,
   writeLiteConfig,
-  disableDefaultAgents,
   detectCurrentConfig,
   loadPluginConfig,
   loadAgentPrompt,
@@ -2309,6 +2334,7 @@ export {
   CUSTOM_SKILLS,
   getCustomSkillsDir,
   findPackageRoot,
+  checkCustomSkillsNeedUpdate,
   installCustomSkills,
   CONTEXT7_MCP_URL,
   context7,

package/dist/cli/config-io.d.ts

@@ -16,6 +16,11 @@ export declare function parseConfig(path: string): {
  */
 export declare function writeConfig(configPath: string, config: OpenCodeConfig): void;
 export declare function addPluginToOpenCodeConfig(): Promise<ConfigMergeResult>;
+export interface OpenCodeMainConfigUpdate {
+    ensurePlugin?: boolean;
+    disableDefaults?: boolean;
+}
+export declare function updateOpenCodeMainConfig(update: OpenCodeMainConfigUpdate): ConfigMergeResult;
 export declare function writeLiteConfig(installConfig: InstallConfig, targetPath?: string): ConfigMergeResult;
 export declare function disableDefaultAgents(): ConfigMergeResult;
 export declare function canModifyOpenCodeConfig(): boolean;

package/dist/cli/custom-skills.d.ts

@@ -1,4 +1,4 @@
-import { type SkillUpdateReason } from './skill-manifest';
+import { type SkillUpdateCheck, type SkillUpdateReason } from './skill-manifest';
 /**
  * A custom skill bundled in this repository.
  * Unlike npx-installed skills, these are copied from src/skills/ to the OpenCode skills directory
@@ -37,6 +37,7 @@ export interface InstallCustomSkillsReport {
  */
 export declare function getCustomSkillsDir(): string;
 export declare function findPackageRoot(startDir: string): string | null;
+export declare function checkCustomSkillsNeedUpdate(packageRoot?: string): SkillUpdateCheck;
 export declare function removeObsoleteSkills(removedSkillNames: string[]): string[];
 export declare function installCustomSkills(packageRoot?: string): InstallCustomSkillsReport;
 /**

package/dist/cli/index.js

@@ -4,7 +4,7 @@ import {
   getOpenCodeVersion,
   isOpenCodeInstalled,
   opencodeAdapter
-} from "../chunk-75JOF37E.js";
+} from "../chunk-6BNAV534.js";
 import {
   CODEX_ROLE_NAMES,
   RECOMMENDED_SKILLS,
@@ -41,19 +41,18 @@ import {
   installRecommendedSkill,
   listOperationHarnesses,
   normalizeEffortSelection
-} from "../chunk-6NMPKYWY.js";
+} from "../chunk-ASKXWU6E.js";
 import {
   ALL_AGENT_NAMES,
   CUSTOM_SKILLS,
   DEFAULT_MODELS,
-  addPluginToOpenCodeConfig,
   detectCurrentConfig,
-  disableDefaultAgents,
   generateLiteConfig,
   getExistingLiteConfigPath,
   installCustomSkills,
+  updateOpenCodeMainConfig,
   writeLiteConfig
-} from "../chunk-YLRPDTU7.js";
+} from "../chunk-OZE7JVGS.js";
 
 // src/cli/index.ts
 import { pathToFileURL } from "url";
@@ -167,7 +166,7 @@ async function runInstall(config) {
   const detected = detectCurrentConfig();
   const isUpdate = detected.isInstalled;
   printHeader(isUpdate);
-  let totalSteps = 4;
+  let totalSteps = 3;
   if (config.installSkills) totalSteps += 1;
   if (config.installCustomSkills) totalSteps += 1;
   let step = 1;
@@ -178,19 +177,19 @@ async function runInstall(config) {
     const { ok } = await checkOpenCodeInstalled();
     if (!ok) return 1;
   }
-  printStep(step++, totalSteps, "Adding thoth-agents plugin...");
-  if (config.dryRun) {
-    printInfo("Dry run mode - skipping plugin installation");
-  } else {
-    const pluginResult = await addPluginToOpenCodeConfig();
-    if (!handleStepResult(pluginResult, "Plugin added")) return 1;
-  }
-  printStep(step++, totalSteps, "Disabling OpenCode default agents...");
+  printStep(
+    step++,
+    totalSteps,
+    "Configuring the thoth-agents plugin and OpenCode default agents..."
+  );
   if (config.dryRun) {
-    printInfo("Dry run mode - skipping agent disabling");
+    printInfo("Dry run mode - skipping main config update");
   } else {
-    const agentResult = disableDefaultAgents();
-    if (!handleStepResult(agentResult, "Default agents disabled")) return 1;
+    const mainConfigResult = updateOpenCodeMainConfig({
+      ensurePlugin: true,
+      disableDefaults: true
+    });
+    if (!handleStepResult(mainConfigResult, "Main config updated")) return 1;
   }
   printStep(step++, totalSteps, "Writing thoth-agents configuration...");
   if (config.dryRun) {
@@ -382,7 +381,7 @@ function formatPaths(paths) {
 }
 function formatWarnings(warnings) {
   return warnings.map(
-    (warning) => `- [${warning.severity}] ${warning.message}`
+    (warning) => `- [${warning.severity}]${warning.code ? ` [${warning.code}]` : ""} ${warning.message}`
   );
 }
 function formatDisclaimers(disclaimers) {
@@ -447,6 +446,7 @@ function formatOperationPlan(plan) {
       `Summary: ${plan.summary}`
     ],
     plan.targets.length > 0 ? ["Targets:", ...plan.targets.map(formatTarget)] : [],
+    plan.blockerTargets?.length ? ["Blocking targets:", ...plan.blockerTargets.map(formatTarget)] : [],
     plan.surfaces.length > 0 ? [
       "Managed surfaces:",
       ...plan.surfaces.map(
@@ -476,6 +476,7 @@ function formatOperationApplyResult(result) {
       `Summary: ${result.summary}`
     ],
     result.changedTargets.length > 0 ? ["Changed targets:", ...result.changedTargets.map(formatTarget)] : [],
+    result.diagnosticTargets?.length ? ["Diagnostic targets:", ...result.diagnosticTargets.map(formatTarget)] : [],
     result.backups.length > 0 ? ["Backups:", ...formatPaths(result.backups)] : [],
     result.warnings.length > 0 ? ["Warnings:", ...formatWarnings(result.warnings)] : [],
     result.disclaimers.length > 0 ? ["Disclaimers:", ...formatDisclaimers(result.disclaimers)] : []

package/dist/cli/operations/types.d.ts

@@ -80,6 +80,7 @@ export interface OperationPlan {
     dryRun: boolean;
     canApply: boolean;
     targets: ManagedTarget[];
+    blockerTargets?: ManagedTarget[];
     surfaces: ManagedSurface[];
     backup: BackupExpectation;
     items: OperationPlanItem[];
@@ -108,6 +109,7 @@ export interface OperationApplyResult {
     applied: boolean;
     summary: string;
     changedTargets: ManagedTarget[];
+    diagnosticTargets?: ManagedTarget[];
     backups: OperationPath[];
     warnings: OperationWarning[];
     disclaimers: OperationDisclaimer[];

package/dist/cli/tui/index.js

@@ -2,8 +2,8 @@ import {
   defaultTuiOperations,
   effortChoicesForModel,
   listOperationHarnesses
-} from "../../chunk-6NMPKYWY.js";
-import "../../chunk-YLRPDTU7.js";
+} from "../../chunk-ASKXWU6E.js";
+import "../../chunk-OZE7JVGS.js";
 
 // src/cli/tui/index.tsx
 import { render } from "ink";
@@ -255,11 +255,21 @@ function PathLine({ label, value, width }) {
 
 // src/cli/tui/components/PlanPreview.tsx
 import { jsx as jsx6, jsxs as jsxs5 } from "react/jsx-runtime";
+function targetText(target) {
+  const label = target.label ?? target.path ?? target.kind;
+  const state = target.state ? `: [${target.state}]` : "";
+  const observed = target.observed ? ` - ${target.observed}` : "";
+  return `${label}${state}${observed}`;
+}
+function warningText(warning) {
+  return `[${warning.severity}]${warning.code ? ` [${warning.code}]` : ""} ${warning.message}`;
+}
 function PlanPreview({
   plan,
   selectedAction,
   result
 }) {
+  const blockerTargets = plan.blockerTargets ?? [];
   return /* @__PURE__ */ jsxs5(Box6, { flexDirection: "column", children: [
     /* @__PURE__ */ jsx6(Text6, { bold: true, children: plan.title }),
     /* @__PURE__ */ jsx6(Text6, { children: plan.summary }),
@@ -275,6 +285,19 @@ function PlanPreview({
       "Can apply: ",
       plan.canApply ? "yes" : "no"
     ] }),
+    !plan.canApply && blockerTargets.length > 0 ? /* @__PURE__ */ jsxs5(Box6, { flexDirection: "column", children: [
+      /* @__PURE__ */ jsx6(Text6, { color: theme.warning, children: "Blocker targets" }),
+      blockerTargets.map((target, index) => /* @__PURE__ */ jsxs5(
+        Text6,
+        {
+          children: [
+            "- ",
+            targetText(target)
+          ]
+        },
+        `${target.label ?? target.path ?? target.kind}-${index}`
+      ))
+    ] }) : null,
     plan.surfaces.length > 0 ? /* @__PURE__ */ jsx6(Text6, { color: theme.dim, children: "Managed surfaces" }) : null,
     plan.surfaces.map((surface) => /* @__PURE__ */ jsxs5(Box6, { flexDirection: "column", children: [
       /* @__PURE__ */ jsxs5(Text6, { children: [
@@ -306,10 +329,8 @@ function PlanPreview({
       " more items"
     ] }) : null,
     plan.warnings.map((warning) => /* @__PURE__ */ jsxs5(Text6, { color: theme.warning, children: [
-      "- [",
-      warning.severity,
-      "] ",
-      warning.message
+      "- ",
+      warningText(warning)
     ] }, warning.code ?? warning.message)),
     plan.disclaimers.map((disclaimer) => /* @__PURE__ */ jsxs5(Text6, { color: theme.dim, children: [
       "- ",
@@ -321,7 +342,33 @@ function PlanPreview({
       /* @__PURE__ */ jsx6(Text6, { color: selectedAction === "cancel" ? theme.accent : void 0, children: "[Cancel]" })
     ] }),
     /* @__PURE__ */ jsx6(Text6, { color: theme.dim, children: "Enter selects. a applies. c cancels." }),
-    result ? /* @__PURE__ */ jsx6(Text6, { color: result.applied ? theme.ok : theme.warning, children: result.summary }) : null
+    result ? /* @__PURE__ */ jsxs5(Box6, { flexDirection: "column", children: [
+      /* @__PURE__ */ jsx6(Text6, { color: result.applied ? theme.ok : theme.warning, children: result.summary }),
+      !result.applied && ((result.diagnosticTargets?.length ?? 0) > 0 || result.warnings.length > 0) ? /* @__PURE__ */ jsxs5(Box6, { flexDirection: "column", children: [
+        /* @__PURE__ */ jsx6(Text6, { color: theme.warning, children: "Apply diagnostics" }),
+        result.diagnosticTargets?.map((target, index) => /* @__PURE__ */ jsxs5(
+          Text6,
+          {
+            children: [
+              "- ",
+              targetText(target)
+            ]
+          },
+          `${target.label ?? target.path ?? target.kind}-${index}`
+        )),
+        result.warnings.map((warning) => /* @__PURE__ */ jsxs5(
+          Text6,
+          {
+            color: theme.warning,
+            children: [
+              "- ",
+              warningText(warning)
+            ]
+          },
+          warning.code ?? warning.message
+        ))
+      ] }) : null
+    ] }) : null
   ] });
 }
 
@@ -348,10 +395,23 @@ var categoryOrder = [
   "Model state",
   "Other"
 ];
+function titleCasePart(part) {
+  const normalized = part.toLowerCase();
+  switch (normalized) {
+    case "sdd":
+      return "SDD";
+    case "cli":
+      return "CLI";
+    case "mcp":
+      return "MCP";
+    case "opencode":
+      return "OpenCode";
+    default:
+      return `${part.charAt(0).toUpperCase()}${part.slice(1).toLowerCase()}`;
+  }
+}
 function titleCase(value, separator = " ") {
-  return value.split(/[-_\s]+/).filter(Boolean).map(
-    (part) => part.toLowerCase() === "sdd" ? "SDD" : part.toLowerCase() === "cli" ? "CLI" : part.toLowerCase() === "mcp" ? "MCP" : part.toLowerCase() === "opencode" ? "OpenCode" : `${part.charAt(0).toUpperCase()}${part.slice(1).toLowerCase()}`
-  ).join(separator);
+  return value.split(/[-_\s]+/).filter(Boolean).map(titleCasePart).join(separator);
 }
 function compactPath(path) {
   return path.replaceAll("\\", "/");
@@ -359,45 +419,56 @@ function compactPath(path) {
 function categorizeTarget(target) {
   const path = target.path ? compactPath(target.path) : "";
   const label = target.label ?? target.kind;
+  const detail = target.state !== "installed" ? target.observed : void 0;
   const agent = path.match(/thoth-agents-([a-z0-9_-]+)\.toml$/i);
   const skill = path.match(/skills\/([^/]+)\/SKILL\.md$/i);
   if (agent?.[1]) {
     return {
       category: "Agents",
       label: titleCase(agent[1]),
-      state: target.state
+      state: target.state,
+      detail
     };
   }
   if (skill?.[1] || target.kind === "skill") {
     return {
       category: "Skills",
-      label: titleCase(skill?.[1] ?? label, "-"),
-      state: target.state
+      label: skill?.[1] ? titleCase(skill[1], "-") : label,
+      state: target.state,
+      detail
     };
   }
   if (/marketplace\.json$/i.test(path)) {
     return {
       category: "Marketplace",
       label: "Marketplace",
-      state: target.state
+      state: target.state,
+      detail
     };
   }
   if (/\.mcp\.json$/i.test(path) || /plugin\.json$/i.test(path) || /plugin-assets/i.test(path) || /manifest/i.test(path)) {
     return {
       category: "Plugin/MCP",
       label: titleCase(label.replace(/^codex\s+/i, "")),
-      state: target.state
+      state: target.state,
+      detail
     };
   }
   if (/AGENTS\.md$/i.test(path) || /root instructions/i.test(label)) {
     return {
       category: "Root instructions",
       label: "AGENTS.md",
-      state: target.state
+      state: target.state,
+      detail
     };
   }
   if (/config\.toml$/i.test(path) || target.kind === "config") {
-    return { category: "Config", label: titleCase(label), state: target.state };
+    return {
+      category: "Config",
+      label: titleCase(label),
+      state: target.state,
+      detail
+    };
   }
   if (target.kind === "memory-state" || /model/i.test(label)) {
     return {
@@ -487,7 +558,9 @@ function StatusView({ report }) {
       warnings.map((warning) => /* @__PURE__ */ jsxs6(Text7, { color: theme.warning, children: [
         "- [",
         warning.severity,
-        "] ",
+        "]",
+        warning.code ? ` [${warning.code}]` : "",
+        " ",
         warning.message
       ] }, warning.code ?? warning.message)),
       hiddenWarnings > 0 ? /* @__PURE__ */ jsxs6(Text7, { color: theme.dim, children: [

package/dist/harness/adapters/codex-surfaces.d.ts

@@ -170,20 +170,19 @@ export declare const CODEX_SURFACES: readonly [{
     readonly id: "per-agent-runtime-permissions";
     readonly target: "permission-control";
     readonly status: "unsupported";
-    readonly fields: ["per-agent tool allow/deny equivalent to OpenCode permissions"];
+    readonly fields: ["named installed-role selection", "per-role permission enforcement", "per-agent tool allow/deny equivalent to OpenCode permissions"];
     readonly diagnosticCode: "codex.permission.memory.enforcement_gap";
-    readonly summary: "Codex sandbox and approval policy can constrain sessions, but OpenCode-style per-agent MCP/tool deny maps are not validated.";
+    readonly summary: "Named installed-role selection and per-role permission enforcement are instruction-only because collaboration.spawn_agent has no role selector; OpenCode-style per-agent MCP/tool deny maps are not validated.";
     readonly evidence: "Codex approvals/security docs cover sandbox and approval policies, not exact OpenCode per-agent permission maps.";
     readonly fallback: "instruction-only";
 }, {
     readonly id: "programmatic-delegation-runtime";
     readonly target: "delegation-runtime";
-    readonly status: "unsupported";
-    readonly fields: ["task API", "background task sessions", "tmux lifecycle hooks", "automatic subagent session close"];
-    readonly diagnosticCode: "codex.delegation.runtime.unsupported";
-    readonly summary: "Codex subagents are user/instruction-triggered; no OpenCode plugin task API or automatic subagent session close parity is validated.";
-    readonly evidence: "Codex subagents docs describe manual spawning and agent threads, not this plugin runtime task API or a validated runtime close hook.";
-    readonly fallback: "instruction-only";
+    readonly status: "validated";
+    readonly fields: ["collaboration.spawn_agent", "collaboration.wait_agent", "collaboration.list_agents", "collaboration.send_message", "collaboration.followup_task", "collaboration.interrupt_agent"];
+    readonly diagnosticCode: "codex.delegation.runtime.validated";
+    readonly summary: "The current Codex collaboration surface supports generic programmatic delegation, mailbox waits, live task-tree inspection, messages, follow-up turns, and explicit interruption.";
+    readonly evidence: "The callable runtime exposes collaboration.spawn_agent with task_name, message, and optional fork_turns plus wait_agent, list_agents, send_message, followup_task, and interrupt_agent.";
 }, {
     readonly id: "parent-context-injection";
     readonly target: "parent-context-injection";

package/dist/harness/core/sdd.d.ts

@@ -15,6 +15,7 @@ export interface SddPhaseContract {
     condition?: string;
     defaultAgentRole?: AgentRoleName;
     alternateAgentRoles?: AgentRoleName[];
+    alternateAgentCondition?: string;
     supportingAgentRoles?: AgentRoleName[];
     persistenceAgentRole?: AgentRoleName;
     delegationReason?: string;
@@ -117,6 +118,7 @@ export declare const SDD_PHASES: readonly [{
     readonly artifactSkill: "sdd-tasks";
     readonly defaultAgentRole: "quick";
     readonly alternateAgentRoles: ["deep"];
+    readonly alternateAgentCondition: "Only when the task plan is complex.";
     readonly delegationReason: "Mechanical conversion of settled design into dependency-ordered execution tasks.";
 }, {
     readonly id: "plan-review";

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   renderOpenCodeAgentConfigs,
   spawn,
   spawnSync
-} from "./chunk-75JOF37E.js";
+} from "./chunk-6BNAV534.js";
 import {
   DEFAULT_THOTH_COMMAND,
   POLL_INTERVAL_BACKGROUND_MS,
@@ -14,7 +14,7 @@ import {
   installCustomSkills,
   loadPluginConfig,
   stripJsonComments
-} from "./chunk-YLRPDTU7.js";
+} from "./chunk-OZE7JVGS.js";
 
 // src/index.ts
 import path4 from "path";