thoth-agents 0.4.2 → 0.5.1

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-WCLUZZHI.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/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-WCLUZZHI.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";

package/dist/cli/types.d.ts

@@ -4,6 +4,7 @@ export interface InstallArgs {
     tui: boolean;
     agent?: InstallAgent;
     localPackageRoot?: string;
+    localPiRuntimeRoot?: string;
     tmux?: BooleanArg;
     dryRun?: boolean;
     reset?: boolean;
@@ -55,6 +56,7 @@ export interface InstallConfig {
     agent: InstallAgent;
     hasTmux: boolean;
     localPackageRoot?: string;
+    localPiRuntimeRoot?: string;
     dryRun?: boolean;
     reset: boolean;
 }

package/dist/config/constants.d.ts

@@ -1,6 +1,6 @@
-type BuiltinAgentName = 'orchestrator' | 'explorer' | 'librarian' | 'oracle' | 'designer' | 'quick' | 'deep';
+type BuiltinAgentName = 'orchestrator' | 'explorer' | 'librarian' | 'oracle' | 'designer' | 'worker';
 export type AgentName = BuiltinAgentName | (string & {});
-export declare const SUBAGENT_NAMES: readonly ["explorer", "librarian", "oracle", "designer", "quick", "deep"];
+export declare const SUBAGENT_NAMES: readonly ["explorer", "librarian", "oracle", "designer", "worker"];
 export declare const ORCHESTRATOR_NAME: "orchestrator";
 export declare const ALL_AGENT_NAMES: readonly BuiltinAgentName[];
 export declare const SUBAGENT_DELEGATION_RULES: Record<AgentName, readonly string[]>;
@@ -21,13 +21,9 @@ export declare const CONFIRMED_OPENAI_SUBAGENT_PRESET: {
         readonly model: "gpt-6-sol";
         readonly effort: "medium";
     };
-    readonly quick: {
+    readonly worker: {
         readonly model: "gpt-6-luna";
-        readonly effort: "medium";
-    };
-    readonly deep: {
-        readonly model: "gpt-6-sol";
-        readonly effort: "medium";
+        readonly effort: "max";
     };
 };
 export declare const OPENCODE_OPENAI_ORCHESTRATOR_PRESET: {

package/dist/config/schema.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-declare const FALLBACK_AGENT_NAMES: readonly ["orchestrator", "oracle", "designer", "explorer", "librarian", "quick", "deep"];
-declare const MANUAL_AGENT_NAMES: readonly ["orchestrator", "oracle", "designer", "explorer", "librarian", "quick", "deep"];
+declare const FALLBACK_AGENT_NAMES: readonly ["orchestrator", "oracle", "designer", "explorer", "librarian", "worker"];
+declare const MANUAL_AGENT_NAMES: readonly ["orchestrator", "oracle", "designer", "explorer", "librarian", "worker"];
 export declare const ManualAgentPlanSchema: z.ZodObject<{
     primary: z.ZodString;
     fallback1: z.ZodString;
@@ -38,13 +38,7 @@ export declare const ManualPlanSchema: z.ZodObject<{
         fallback2: z.ZodString;
         fallback3: z.ZodString;
     }, z.core.$strip>;
-    quick: z.ZodObject<{
-        primary: z.ZodString;
-        fallback1: z.ZodString;
-        fallback2: z.ZodString;
-        fallback3: z.ZodString;
-    }, z.core.$strip>;
-    deep: z.ZodObject<{
+    worker: z.ZodObject<{
         primary: z.ZodString;
         fallback1: z.ZodString;
         fallback2: z.ZodString;
@@ -106,8 +100,7 @@ export declare const AgentNameSchema: z.ZodEnum<{
     librarian: "librarian";
     oracle: "oracle";
     designer: "designer";
-    quick: "quick";
-    deep: "deep";
+    worker: "worker";
 }>;
 export declare const McpNameSchema: z.ZodEnum<{
     exa: "exa";
@@ -131,15 +124,7 @@ export declare const FailoverConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     timeoutMs: z.ZodDefault<z.ZodNumber>;
     retryDelayMs: z.ZodDefault<z.ZodNumber>;
-    chains: z.ZodDefault<z.ZodObject<{
-        orchestrator: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        oracle: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        designer: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        explorer: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        librarian: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        quick: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        deep: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$catchall<z.ZodArray<z.ZodString>>>>;
+    chains: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
 }, z.core.$strip>;
 export type FailoverConfig = z.infer<typeof FailoverConfigSchema>;
 export declare const PluginConfigSchema: z.ZodObject<{
@@ -183,13 +168,7 @@ export declare const PluginConfigSchema: z.ZodObject<{
             fallback2: z.ZodString;
             fallback3: z.ZodString;
         }, z.core.$strip>;
-        quick: z.ZodObject<{
-            primary: z.ZodString;
-            fallback1: z.ZodString;
-            fallback2: z.ZodString;
-            fallback3: z.ZodString;
-        }, z.core.$strip>;
-        deep: z.ZodObject<{
+        worker: z.ZodObject<{
             primary: z.ZodString;
             fallback1: z.ZodString;
             fallback2: z.ZodString;
@@ -230,15 +209,7 @@ export declare const PluginConfigSchema: z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         timeoutMs: z.ZodDefault<z.ZodNumber>;
         retryDelayMs: z.ZodDefault<z.ZodNumber>;
-        chains: z.ZodDefault<z.ZodObject<{
-            orchestrator: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            oracle: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            designer: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            explorer: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            librarian: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            quick: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            deep: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        }, z.core.$catchall<z.ZodArray<z.ZodString>>>>;
+        chains: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>>;
     codex: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;