thoth-agents 0.4.1 → 0.5.0

package/dist/cli/claude-code-paths.d.ts

@@ -1,3 +1,3 @@
 export type ClaudeCodeInstallScope = 'project' | 'user';
-export type ClaudeCodeRoleName = 'explorer' | 'librarian' | 'oracle' | 'designer' | 'quick' | 'deep';
-export declare const CLAUDE_CODE_ROLE_NAMES: readonly ["explorer", "librarian", "oracle", "designer", "quick", "deep"];
+export type ClaudeCodeRoleName = 'explorer' | 'librarian' | 'oracle' | 'designer' | 'worker';
+export declare const CLAUDE_CODE_ROLE_NAMES: readonly ["explorer", "librarian", "oracle", "designer", "worker"];

package/dist/cli/codex-install.d.ts

@@ -1,8 +1,8 @@
 import type { CodexInstallScope, CodexRoleName } from './codex-paths';
 import { type ManagedModelState } from './managed-state-io';
 export { CODEX_ROLE_NAMES } from './codex-paths';
-export type CodexSetupAction = 'merge-managed-block' | 'write-role-toml' | 'write-managed-model-state' | 'merge-toml' | 'diagnose-only';
-export type CodexTargetKind = 'root-instructions' | 'role-subagent-toml' | 'managed-model-state' | 'user-config' | 'diagnostic';
+export type CodexSetupAction = 'merge-managed-block' | 'write-role-toml' | 'retire-obsolete-role-toml' | 'write-install-recovery' | 'write-managed-model-state' | 'merge-toml' | 'diagnose-only';
+export type CodexTargetKind = 'root-instructions' | 'role-subagent-toml' | 'managed-model-state' | 'install-recovery' | 'user-config' | 'diagnostic';
 export interface CodexInstallConfig {
     dryRun?: boolean;
     reset: boolean;
@@ -22,6 +22,9 @@ export interface CodexSetupPlanItem {
     content?: string;
     role?: CodexRoleName;
     renderedModel?: string;
+    /** Apply-time guard captured while planning. */
+    expectedContent?: string;
+    expectedAbsent?: boolean;
 }
 export interface CodexSetupPlan {
     dryRun: boolean;

package/dist/cli/codex-paths.d.ts

@@ -1,6 +1,6 @@
 export type CodexInstallScope = 'project' | 'user';
-export type CodexRoleName = 'explorer' | 'librarian' | 'oracle' | 'designer' | 'quick' | 'deep';
-export declare const CODEX_ROLE_NAMES: readonly ["explorer", "librarian", "oracle", "designer", "quick", "deep"];
+export type CodexRoleName = 'explorer' | 'librarian' | 'oracle' | 'designer' | 'worker';
+export declare const CODEX_ROLE_NAMES: readonly ["explorer", "librarian", "oracle", "designer", "worker"];
 export interface CodexTargetResolverOptions {
     scope: CodexInstallScope;
     projectRoot: string;

package/dist/cli/index.js

@@ -4,7 +4,7 @@ import {
   getOpenCodeVersion,
   isOpenCodeInstalled,
   opencodeAdapter
-} from "../chunk-STCURXAQ.js";
+} from "../chunk-MRFCA3U2.js";
 import {
   CODEX_ROLE_NAMES,
   REQUIRED_SKILLS,
@@ -59,11 +59,11 @@ import {
   normalizeEffortSelection,
   recordHarnessInstallCompletion,
   syncOpenCodeOwnedSkills
-} from "../chunk-2D7E7GMP.js";
+} from "../chunk-VUNYH263.js";
 import "../chunk-62L3ORXN.js";
 import {
   piAdapter
-} from "../chunk-2U5MBLLV.js";
+} from "../chunk-V7HSGRMB.js";
 import {
   ALL_AGENT_NAMES,
   detectCurrentConfig,
@@ -74,7 +74,7 @@ import {
   resolveExecutingPackageVersion,
   updateOpenCodeMainConfig,
   writeLiteConfig
-} from "../chunk-EFGSGPYM.js";
+} from "../chunk-OW6I7ZUU.js";
 
 // src/cli/index.ts
 import { pathToFileURL } from "url";
@@ -171,7 +171,9 @@ function formatConfigSummary(dryRun) {
   lines.push(`  ${BOLD}Preset:${RESET} ${BLUE}openai${RESET}`);
   lines.push(`  ${SYMBOLS.check} Seven-role adaptive thoth-agents roster`);
   lines.push(`  ${SYMBOLS.check} OpenAI models by default`);
-  lines.push(`  ${SYMBOLS.check} Direct, Accelerated, and Full SDD routing`);
+  lines.push(
+    `  ${SYMBOLS.check} Proportional SDD and ID-named substantial-change records`
+  );
   lines.push(
     `  ${SYMBOLS.check} ${dryRun ? "thoth-mem setup plan confirmed" : "thoth-mem setup completed through its provider-owned installer"}`
   );
@@ -392,7 +394,7 @@ ${JSON.stringify(liteConfig, null, 2)}
   const modelsInfo = "Default configuration uses OpenAI models.";
   console.log(`${BOLD}${modelsInfo}${RESET}`);
   console.log(
-    `  ${DIM}Includes the seven-role adaptive roster, native delegation, and Direct / Accelerated / Full SDD routing.${RESET}`
+    `  ${DIM}Includes the seven-role adaptive roster, native parallel delegation, and proportional SDD governance.${RESET}`
   );
   return 0;
 }
@@ -407,6 +409,7 @@ async function runPiInstall(config, dependencies, packageVersion, executingPacka
     expectedVersion: packageVersion,
     packageRoot: executingPackageRoot,
     ...config.localPackageRoot ? { firstPartySource: config.localPackageRoot } : {},
+    ...config.localPiRuntimeRoot ? { runtimePackageRoot: config.localPiRuntimeRoot } : {},
     receiptOptions: dependencies.installLedgerOptions,
     verifyFirstParty: dependencies.verifyPiFirstParty
   });
@@ -483,6 +486,7 @@ function createInstallConfig(args) {
     agent: args.agent ?? "opencode",
     hasTmux: args.tmux === "yes",
     ...args.localPackageRoot ? { localPackageRoot: args.localPackageRoot } : {},
+    ...args.localPiRuntimeRoot ? { localPiRuntimeRoot: args.localPiRuntimeRoot } : {},
     dryRun: args.dryRun,
     reset: args.reset ?? false
   };
@@ -788,7 +792,7 @@ Codex and Claude marketplace versions remain native-manager-owned and do not pro
 that CLI-managed agents, skills, configuration, or provider setup are aligned.
 Runtime release checks notify only; use the latest CLI install or interactive CLI Update.
 
-OpenCode install configures the adaptive seven-role roster and native task delegation.
+OpenCode install configures the adaptive six-role roster and native task delegation.
 Provider capability is external and reported only from caller-supplied evidence.
 
 External required skills are installed for every harness:
@@ -897,8 +901,8 @@ function printModelGuidance() {
     [
       "Model command requires explicit model input.",
       "Examples:",
-      "  thoth-agents model --harness=codex --role=deep --model=openai/gpt-5.4-mini",
-      "  thoth-agents model --harness=opencode --role-model=deep=openai/gpt-5.4",
+      "  thoth-agents model --harness=codex --role=worker --model=openai/gpt-5.4-mini",
+      "  thoth-agents model --harness=opencode --role-model=worker=openai/gpt-5.4",
       "Preview is the default. Add --apply only after reviewing the plan."
     ].join("\n")
   );
@@ -1075,15 +1079,20 @@ function parseOperationHarness(value) {
   }
   return value;
 }
+function assertSupportedRoleName(role) {
+  if (role === "quick" || role === "deep")
+    throw new Error(`Unsupported removed agent role: ${role}. Use worker.`);
+}
 function parseRoleModel(value) {
   const separator = value.includes("=") ? "=" : ":";
   const [role, ...modelParts] = value.split(separator);
   const model = modelParts.join(separator);
   if (!role || !model) {
     throw new Error(
-      "--role-model must use role=model or role:model, for example --role-model=deep=openai/gpt-5.4-mini."
+      "--role-model must use role=model or role:model, for example --role-model=worker=openai/gpt-5.4-mini."
     );
   }
+  assertSupportedRoleName(role);
   return { role, model };
 }
 function parseRoleEffort(value) {
@@ -1092,9 +1101,10 @@ function parseRoleEffort(value) {
   const effort = effortParts.join(separator);
   if (!role || !effort) {
     throw new Error(
-      "--role-effort must use role=effort or role:effort, for example --role-effort=deep=high."
+      "--role-effort must use role=effort or role:effort, for example --role-effort=worker=high."
     );
   }
+  assertSupportedRoleName(role);
   return { role, effort: normalizeEffortSelection(effort) };
 }
 function parseOperationArgs(args) {
@@ -1140,6 +1150,7 @@ function parseOperationArgs(args) {
     } else if (arg.startsWith("--role=")) {
       pendingRole = arg.split("=")[1] ?? "";
       if (!pendingRole) throw new Error("--role requires a value.");
+      assertSupportedRoleName(pendingRole);
     } else if (arg.startsWith("--provider=")) {
       pendingProvider = arg.split("=")[1] ?? "";
       if (!pendingProvider) throw new Error("--provider requires a value.");
@@ -1212,6 +1223,26 @@ function parseInstallArgs(args) {
         );
       }
       result.localPackageRoot = localPackageRoot;
+    } else if (arg === "--local-pi-runtime-root" || arg.startsWith("--local-pi-runtime-root=")) {
+      if (result.localPiRuntimeRoot !== void 0) {
+        throw new Error("--local-pi-runtime-root cannot be repeated.");
+      }
+      let localPiRuntimeRoot;
+      if (arg === "--local-pi-runtime-root") {
+        index += 1;
+        localPiRuntimeRoot = args[index];
+      } else {
+        localPiRuntimeRoot = arg.slice("--local-pi-runtime-root=".length);
+      }
+      if (!localPiRuntimeRoot || localPiRuntimeRoot.startsWith("--")) {
+        throw new Error("--local-pi-runtime-root requires a value.");
+      }
+      if (!isAbsolute(localPiRuntimeRoot) || resolve(localPiRuntimeRoot) !== localPiRuntimeRoot) {
+        throw new Error(
+          "--local-pi-runtime-root requires a normalized absolute path."
+        );
+      }
+      result.localPiRuntimeRoot = localPiRuntimeRoot;
     } else if (arg === "-h" || arg === "--help") {
       throw new Error("help");
     } else {
@@ -1221,6 +1252,11 @@ function parseInstallArgs(args) {
   if (result.localPackageRoot !== void 0 && result.agent !== "pi") {
     throw new Error("--local-package-root is supported only with --agent=pi.");
   }
+  if (result.localPiRuntimeRoot !== void 0 && result.agent !== "pi") {
+    throw new Error(
+      "--local-pi-runtime-root is supported only with --agent=pi."
+    );
+  }
   return result;
 }
 function parseGenerateArgs(args) {

package/dist/cli/model-defaults.d.ts

@@ -0,0 +1,4 @@
+import type { HarnessId } from '../harness/types';
+import type { ModelRoleInput } from './operations/types';
+/** Shipped recommendations, independent of installed configuration. */
+export declare function getShippedModelRoles(harness: HarnessId): ModelRoleInput[];

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

@@ -8,6 +8,7 @@ import type { HarnessAction, HarnessStatusReport, ModelConfigInput, ModelRoleInp
 export interface PiOperationContext extends OperationContext {
     homeDir?: string;
     packageRoot?: string;
+    runtimePackageRoot?: string;
     env?: Readonly<Record<string, string | undefined>>;
     installLedgerOptions?: InstallLedgerOptions;
     buildPiSetupPlan?: typeof buildPiSetupPlan;

package/dist/cli/pi-effort.d.ts

@@ -1,5 +1,5 @@
 import type { ModelRoleInput } from './operations/types';
-export declare const PI_EFFORT_VALUES: readonly ["off", "minimal", "low", "medium", "high", "xhigh"];
+export declare const PI_EFFORT_VALUES: readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
 export type PiEffortResolution = {
     ok: true;
     effort: string | undefined;

package/dist/cli/pi-external-package.d.ts

@@ -0,0 +1,24 @@
+export interface PiExternalPackageSpec {
+    source: string;
+    packageName: string;
+    version: string;
+}
+export interface PiConfiguredExternalPackage {
+    scope: 'user' | 'project';
+    source: string;
+    installedPath?: string;
+}
+export type PiExternalPackageEvidence = {
+    state: 'installed';
+    source: string;
+    installedPath: string;
+    version: string;
+} | {
+    state: 'missing' | 'drift';
+    source?: string;
+    installedPath?: string;
+    version?: string;
+    reason: string;
+};
+export declare function piExternalSourceMatches(candidate: PiConfiguredExternalPackage, expectedSource: string): boolean;
+export declare function inspectPiExternalPackage(packages: readonly PiConfiguredExternalPackage[], spec: PiExternalPackageSpec, requireManagedSource?: boolean): PiExternalPackageEvidence;

package/dist/cli/pi-git-source.d.ts

@@ -0,0 +1 @@
+export declare function projectGitPackagePath(source: string, projectRoot: string): string | undefined;

package/dist/cli/pi-install.d.ts

@@ -1,38 +1,38 @@
 import { type PiPackageReceipt, type PiPackageReceiptOptions } from './pi-package-receipt';
 import { type PiPathOptions, type PiPaths } from './pi-paths';
-export declare const PI_MINIMUM_VERSION = "0.84.4";
+export declare const PI_MINIMUM_VERSION = "0.99.0";
 export declare const PI_NODE_MINIMUM = "22.19.0";
 export declare const PI_COMMAND_TIMEOUT_MS = 120000;
 export declare const PI_PACKAGE_SPECS: readonly [{
     readonly id: "delegation";
-    readonly source: "npm:pi-subagents-j0k3r@1.5.9";
-    readonly packageName: "pi-subagents-j0k3r";
-    readonly version: "1.5.9";
+    readonly source: "npm:@thoth-agents/pi-subagents@>=0.1.0";
+    readonly packageName: "@thoth-agents/pi-subagents";
+    readonly version: "0.1.0";
 }, {
     readonly id: "context7";
-    readonly source: "npm:@upstash/context7-pi@0.1.2";
+    readonly source: "npm:@upstash/context7-pi@>=0.1.2";
     readonly packageName: "@upstash/context7-pi";
     readonly version: "0.1.2";
 }, {
     readonly id: "web-access";
-    readonly source: "npm:pi-web-access@0.27.0";
+    readonly source: "npm:pi-web-access@>=0.27.0";
     readonly packageName: "pi-web-access";
     readonly version: "0.27.0";
 }, {
     readonly id: "grep-adapter";
-    readonly source: "npm:pi-mcp-adapter@2.32.1";
+    readonly source: "npm:pi-mcp-adapter@>=2.32.1";
     readonly packageName: "pi-mcp-adapter";
     readonly version: "2.32.1";
 }, {
     readonly id: "ask-user-question";
-    readonly source: "npm:@juicesharp/rpiv-ask-user-question@2.9.0";
-    readonly packageName: "@juicesharp/rpiv-ask-user-question";
-    readonly version: "2.9.0";
+    readonly source: "npm:@thoth-agents/pi-questions-user@>=0.1.0";
+    readonly packageName: "@thoth-agents/pi-questions-user";
+    readonly version: "0.1.0";
 }, {
     readonly id: "todo";
-    readonly source: "npm:@juicesharp/rpiv-todo@2.9.0";
-    readonly packageName: "@juicesharp/rpiv-todo";
-    readonly version: "2.9.0";
+    readonly source: "npm:@thoth-agents/pi-todo@>=0.1.0";
+    readonly packageName: "@thoth-agents/pi-todo";
+    readonly version: "0.1.0";
 }];
 export declare const PI_GREP_MCP_ENTRY: {
     readonly url: "https://mcp.grep.app";
@@ -51,6 +51,7 @@ export interface PiSetupOptions extends PiPathOptions {
     commandExecutor?: PiCommandExecutor;
     expectedVersion?: string;
     packageRoot?: string;
+    runtimePackageRoot?: string;
     firstPartySource?: string;
     receiptOptions?: PiPackageReceiptOptions;
     verifyFirstParty?: (input: {
@@ -67,7 +68,7 @@ export interface PiSetupOptions extends PiPathOptions {
     };
 }
 export interface PiSetupPlanItem {
-    kind: 'preflight' | 'package' | 'root' | 'agent' | 'mcp';
+    kind: 'preflight' | 'package' | 'root' | 'agent' | 'settings' | 'mcp';
     description: string;
     target: string;
     command?: {
@@ -84,6 +85,7 @@ export interface PiSetupPlan {
     blockers: string[];
     diagnostics: string[];
     disclaimers: string[];
+    projectIncumbentTodos?: PiConfiguredPackage[];
     options: PiSetupOptions;
 }
 export interface PiApplyResult {
@@ -111,6 +113,70 @@ export declare function verifyPiFirstPartyPackage(input: {
     success: false;
     error: string;
 };
+export declare function isPiIncumbentDelegationSource(source: string): boolean;
+export declare function getPiExternalPackageSpecs(options?: Pick<PiSetupOptions, 'runtimePackageRoot'>): readonly [{
+    readonly id: "delegation";
+    readonly source: "npm:@thoth-agents/pi-subagents@>=0.1.0";
+    readonly packageName: "@thoth-agents/pi-subagents";
+    readonly version: "0.1.0";
+}, {
+    readonly id: "context7";
+    readonly source: "npm:@upstash/context7-pi@>=0.1.2";
+    readonly packageName: "@upstash/context7-pi";
+    readonly version: "0.1.2";
+}, {
+    readonly id: "web-access";
+    readonly source: "npm:pi-web-access@>=0.27.0";
+    readonly packageName: "pi-web-access";
+    readonly version: "0.27.0";
+}, {
+    readonly id: "grep-adapter";
+    readonly source: "npm:pi-mcp-adapter@>=2.32.1";
+    readonly packageName: "pi-mcp-adapter";
+    readonly version: "2.32.1";
+}, {
+    readonly id: "ask-user-question";
+    readonly source: "npm:@thoth-agents/pi-questions-user@>=0.1.0";
+    readonly packageName: "@thoth-agents/pi-questions-user";
+    readonly version: "0.1.0";
+}, {
+    readonly id: "todo";
+    readonly source: "npm:@thoth-agents/pi-todo@>=0.1.0";
+    readonly packageName: "@thoth-agents/pi-todo";
+    readonly version: "0.1.0";
+}] | ({
+    readonly id: "context7";
+    readonly source: "npm:@upstash/context7-pi@>=0.1.2";
+    readonly packageName: "@upstash/context7-pi";
+    readonly version: "0.1.2";
+} | {
+    readonly id: "web-access";
+    readonly source: "npm:pi-web-access@>=0.27.0";
+    readonly packageName: "pi-web-access";
+    readonly version: "0.27.0";
+} | {
+    readonly id: "grep-adapter";
+    readonly source: "npm:pi-mcp-adapter@>=2.32.1";
+    readonly packageName: "pi-mcp-adapter";
+    readonly version: "2.32.1";
+} | {
+    readonly id: "ask-user-question";
+    readonly source: "npm:@thoth-agents/pi-questions-user@>=0.1.0";
+    readonly packageName: "@thoth-agents/pi-questions-user";
+    readonly version: "0.1.0";
+} | {
+    readonly id: "todo";
+    readonly source: "npm:@thoth-agents/pi-todo@>=0.1.0";
+    readonly packageName: "@thoth-agents/pi-todo";
+    readonly version: "0.1.0";
+} | {
+    source: string;
+    id: "delegation";
+    packageName: "@thoth-agents/pi-subagents";
+    version: "0.1.0";
+})[];
+export declare function piIncumbentTodoRecovery(source: string, scope: PiConfiguredPackage['scope'], identityLimitation?: string, unmappedSource?: boolean): string;
+export declare function mergePiSubagentsConfig(current: Record<string, unknown>): Record<string, unknown>;
 export declare function mergePiGrepMcpConfig(current: Record<string, unknown>): Record<string, unknown>;
 export declare function mergePiRootBlock(current: string, managedBlock: string): string;
 export declare function buildPiSetupPlan(options?: PiSetupOptions): PiSetupPlan;
@@ -123,9 +189,20 @@ export interface PiConfiguredPackage {
     installedPath?: string;
     packageName?: string;
     packageVersion?: string;
+    identityLimitation?: string;
+    /** Directory-only evidence; source is a display path, not a removal source. */
+    unmappedSource?: boolean;
 }
 export declare function parsePiPackageList(output: string): PiConfiguredPackage[];
+export interface PiIncumbentDelegation {
+    candidate: PiConfiguredPackage;
+    classification: 'confirmed' | 'ambiguous';
+    reason: string;
+}
+export declare function findPiIncumbentDelegation(packages: readonly PiConfiguredPackage[]): PiIncumbentDelegation | undefined;
+export declare function findPiIncumbentTodos(packages: readonly PiConfiguredPackage[]): PiConfiguredPackage[];
+export declare function piIncumbentDelegationRecovery(incumbent: PiIncumbentDelegation): string;
 export declare function isThothPackageLocation(candidate: PiConfiguredPackage, knownSource?: string): boolean;
 export declare function getPiFirstPartyPackages(packages: readonly PiConfiguredPackage[], knownSource?: string): PiConfiguredPackage[];
-export declare function writePiManagedText(path: string, content: string): boolean;
+export { writePiManagedText } from './pi-managed-write';
 export declare function applyPiSetup(plan: PiSetupPlan): PiApplyResult;

package/dist/cli/pi-managed-write.d.ts

@@ -0,0 +1,3 @@
+/** Reject links and non-directory ancestors before reading or writing a managed file. */
+export declare function assertSafePiManagedPath(path: string): void;
+export declare function writePiManagedText(path: string, content: string, expectedBefore?: string | null): boolean;

package/dist/cli/pi-model-config.d.ts

@@ -0,0 +1,17 @@
+import { type PiSpecialistRole } from '../harness/pi-specialists';
+import type { ModelRoleInput } from './operations/types';
+export interface PiModelSnapshot {
+    piRoot: string;
+    roles: ModelRoleInput[];
+    contents: Partial<Record<PiSpecialistRole, string>>;
+}
+export interface PiModelSaveResult {
+    success: boolean;
+    changedRoles: PiSpecialistRole[];
+    /** Reflects only successful writes; use this snapshot to retry the same draft. */
+    snapshot: PiModelSnapshot;
+    error?: string;
+}
+export declare function readOwnedPiSpecialistDefinition(piRoot: string, role: PiSpecialistRole): string;
+export declare function readPiModelConfig(piRoot: string, roles?: readonly PiSpecialistRole[]): PiModelSnapshot;
+export declare function savePiModelConfig(snapshot: PiModelSnapshot, roles: readonly ModelRoleInput[]): PiModelSaveResult;

package/dist/cli/pi-native-probe.d.ts

@@ -31,4 +31,6 @@ export interface PiNativeProbeResult {
     orchestratorChild?: boolean;
     sessionStartCount?: number;
 }
+export declare function resolvePiWindowsCliFromShim(shimPath: string, shimContents: string): string | undefined;
+export declare function findPiWindowsCli(): string | undefined;
 export declare function observePiNativeRoot(options: PiNativeProbeOptions): PiNativeProbeResult;

package/dist/cli/pi-paths.d.ts

@@ -13,6 +13,8 @@ export interface PiPaths {
     agentsRoot: string;
     alternateAgentsRoot: string;
     ownedSkillsRoot: string;
+    settingsPath: string;
+    subagentsConfigPath: string;
     mcpConfigPath: string;
     projectAgentRoots: string[];
     projectMcpPaths: string[];

package/dist/cli/pi-resources.d.ts

@@ -1,9 +1,11 @@
-export declare const PI_SPECIALIST_NAMES: ("thoth-explorer" | "thoth-librarian" | "thoth-oracle" | "thoth-designer" | "thoth-quick" | "thoth-deep")[];
+export declare const PI_SPECIALIST_NAMES: ("thoth-explorer" | "thoth-librarian" | "thoth-oracle" | "thoth-designer" | "thoth-worker")[];
 export interface PiSpecialistSyncOptions {
     packageRoot: string;
     piRoot: string;
     dryRun?: boolean;
     projectRoots?: readonly string[];
+    /** Test-only seam for exercising replacement races before retirement. */
+    beforeRetireForTest?: () => void;
 }
 export interface PiSpecialistSyncResult {
     success: boolean;

package/dist/cli/pi-tool-config.d.ts

@@ -0,0 +1,32 @@
+import { type PiSpecialistRole } from '../harness/pi-specialists';
+export interface PiToolRoleSnapshot {
+    role: PiSpecialistRole;
+    tools: string[];
+    defaultTools: string[];
+    disallowedTools: string[];
+}
+export interface PiToolConfigSnapshot {
+    piRoot: string;
+    roles: PiToolRoleSnapshot[];
+    contents: Partial<Record<PiSpecialistRole, string>>;
+}
+export interface PiToolRoleInput {
+    role: PiSpecialistRole;
+    tools: readonly string[];
+}
+export interface PiToolSaveResult {
+    success: boolean;
+    changedRoles: PiSpecialistRole[];
+    /** Reflects only successful writes; pass it back to retry the same draft. */
+    snapshot: PiToolConfigSnapshot;
+    error?: string;
+}
+export interface PiSpecialistToolOverrides {
+    tools?: string[];
+    disallowedTools?: string[];
+    subagentMode?: 'task' | 'background';
+}
+export declare function validatePiSpecialistTools(tools: readonly string[]): void;
+export declare function readPiSpecialistToolOverrides(content: string): PiSpecialistToolOverrides;
+export declare function readPiToolConfig(piRoot: string, roles?: readonly PiSpecialistRole[]): PiToolConfigSnapshot;
+export declare function savePiToolConfig(snapshot: PiToolConfigSnapshot, roles: readonly PiToolRoleInput[]): PiToolSaveResult;

package/dist/cli/tui/index.js

@@ -2,10 +2,10 @@ import {
   defaultTuiOperations,
   effortChoicesForModel,
   listOperationHarnesses
-} from "../../chunk-2D7E7GMP.js";
+} from "../../chunk-VUNYH263.js";
 import "../../chunk-62L3ORXN.js";
-import "../../chunk-2U5MBLLV.js";
-import "../../chunk-EFGSGPYM.js";
+import "../../chunk-V7HSGRMB.js";
+import "../../chunk-OW6I7ZUU.js";
 
 // src/cli/tui/index.tsx
 import { render } from "ink";
@@ -875,6 +875,7 @@ function App({
   const providerEvidenceRequest = useRef(0);
   const [plan, setPlan] = useState();
   const [result, setResult] = useState();
+  const [restoringDefaults, setRestoringDefaults] = useState(false);
   const [previewAction, setPreviewAction] = useState(
     "cancel"
   );
@@ -948,7 +949,7 @@ function App({
   const choiceSelected = selectedModelIndex < 0 ? 0 : selectedModelIndex;
   const dirtyRoles = rolesForModelPlan(modelRows);
   const rolesToApply = dirtyRoles.length > 0 ? dirtyRoles : rolesForModelPlan(modelRows, true);
-  const modelActions = dirtyRoles.length > 0 ? ["Preview changes", "Apply", "Back"] : ["Apply", "Back"];
+  const modelActions = dirtyRoles.length > 0 ? ["Preview changes", "Apply", "Restore defaults", "Back"] : ["Apply", "Restore defaults", "Back"];
   const modelMenuItems = [
     ...modelRows.map((role) => ({
       id: role.role,
@@ -990,6 +991,7 @@ function App({
   }
   function openPlan(harness, action, backView = "harness") {
     setActiveHarness(harness);
+    setRestoringDefaults(false);
     setPlan(operations.plan(harness, action));
     setResult(void 0);
     setPreviewAction("cancel");
@@ -1037,6 +1039,7 @@ function App({
     setView("effortChoice");
   }
   function previewModelChanges(applyImmediately) {
+    setRestoringDefaults(false);
     const nextPlan = operations.modelPlan(modelHarness, rolesToApply);
     setPlan(nextPlan);
     setPreviewAction(applyImmediately ? "apply" : "cancel");
@@ -1067,6 +1070,26 @@ function App({
     setResult(void 0);
     setView("preview");
   }
+  function previewDefaultModels() {
+    setPlan(operations.restoreModelPlan(modelHarness, modelOptions));
+    setRestoringDefaults(true);
+    setResult(void 0);
+    setPreviewAction("cancel");
+    setPreviewBackView("modelRoles");
+    setView("preview");
+  }
+  function applyPreview() {
+    if (!plan?.canApply || restoringDefaults && result?.applied) return;
+    const applied = operations.apply(plan);
+    setResult(applied);
+    if (restoringDefaults && applied.applied) {
+      setModelRoles(operations.modelRoles(modelHarness));
+      setEditedModels({});
+      setEditedEfforts({});
+      setModelResult(void 0);
+      setModelSelected(0);
+    }
+  }
   useInput((input, key) => {
     if (view === "modelEdit") {
       if (key.escape) {
@@ -1286,6 +1309,7 @@ function App({
         if (action === "Back") setView("manageHarness");
         if (action === "Preview changes") previewModelChanges(false);
         if (action === "Apply") previewModelChanges(true);
+        if (action === "Restore defaults") previewDefaultModels();
       }
       return;
     }
@@ -1301,14 +1325,14 @@ function App({
       }
       if (input === "a" && plan?.canApply) {
         setPreviewAction("apply");
-        setResult(operations.apply(plan));
+        applyPreview();
       }
       if (input === "c") goBack();
       if (key.return && plan) {
         if (previewAction === "cancel" || !plan.canApply) {
           goBack();
         } else {
-          setResult(operations.apply(plan));
+          applyPreview();
         }
       }
     }
@@ -1465,10 +1489,11 @@ function App({
       /* @__PURE__ */ jsx8(
         Header,
         {
-          title: plan.title,
+          title: restoringDefaults ? "Restore default models" : plan.title,
           subtitle: "Enter selects. Escape or c returns one level."
         }
       ),
+      restoringDefaults ? /* @__PURE__ */ jsx8(Text8, { color: theme.warning, children: "Replace all managed role models and reasoning efforts with this package's defaults. Review the values and targets below. Apply writes changes; Cancel keeps your current settings." }) : null,
       /* @__PURE__ */ jsx8(
         PlanPreview,
         {

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

@@ -1,7 +1,7 @@
 import type { HarnessId, ProviderCapabilityEvidence, ProviderEvidenceInput } from '../../harness/types';
 import { type ClaudeCodeOperationContext } from '../operations/claude-code';
 import { type CodexOperationContext } from '../operations/codex';
-import type { HarnessStatusReport, ModelRoleInput, OperationApplyResult, OperationPlan } from '../operations/types';
+import type { HarnessStatusReport, ModelRoleInput, OperationApplyResult, OperationContext, OperationPlan } from '../operations/types';
 import { type ModelOption } from './model-catalog';
 export type TuiAction = 'status' | 'list' | 'install' | 'update' | 'sync' | 'model';
 export interface TuiOperations {
@@ -11,6 +11,7 @@ export interface TuiOperations {
     modelOptions(harness: HarnessId): Promise<ModelOption[]>;
     plan(harness: HarnessId, action: Exclude<TuiAction, 'status' | 'list'>): OperationPlan;
     modelPlan(harness: HarnessId, roles: ModelRoleInput[]): OperationPlan;
+    restoreModelPlan(harness: HarnessId, options: readonly ModelOption[]): OperationPlan;
     apply(plan: OperationPlan): OperationApplyResult;
 }
 export declare const opencodeModelRoles: ModelRoleInput[];
@@ -19,4 +20,5 @@ export declare function getCodexModelRoles(source?: CodexOperationContext): Mode
 export declare function getClaudeCodeModelRoles(_source?: ClaudeCodeOperationContext): ModelRoleInput[];
 export declare function getPiModelRoles(): ModelRoleInput[];
 export declare function getOpenCodeModelRoles(): ModelRoleInput[];
+export declare function buildRestoreModelPlan(harness: HarnessId, options: readonly ModelOption[], source?: OperationContext): OperationPlan;
 export declare const defaultTuiOperations: TuiOperations;