thoth-agents 0.7.0 → 0.8.0

package/dist/{chunk-P3GDM5RH.js → chunk-P7R4GDSO.js}

@@ -19,7 +19,7 @@ import {
   renderAgentRoutingDescription,
   renderPromptSection,
   renderRolePrompt
-} from "./chunk-QOIZYJ5C.js";
+} from "./chunk-4DZSWTUM.js";
 
 // src/harness/writers/pi-agent.ts
 var PI_MANAGED_OWNER = "thoth-agents";

package/dist/{chunk-3MHJGWS4.js → chunk-ZLEMG37R.js}

@@ -16,7 +16,7 @@ import {
   loadAgentPrompt,
   renderAgentRoutingDescription,
   renderRolePrompt
-} from "./chunk-QOIZYJ5C.js";
+} from "./chunk-4DZSWTUM.js";
 
 // src/agents/designer.ts
 var DESIGNER_PROMPT = renderRolePrompt(

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

@@ -15,6 +15,8 @@ export interface CodexConfigMergeResult {
     changed: boolean;
     diffSummary: string[];
     warnings: string[];
+    /** Raw prior TOML integer, or null when originally absent. */
+    priorThreadsValue?: string | null;
     error?: string;
 }
 export declare function parseCodexToml(content: string): CodexTomlDocument;
@@ -26,10 +28,40 @@ export declare function mergeCodexManagedConfig(document: CodexTomlDocument, opt
     diffSummary: string[];
     warnings: string[];
 };
+interface TomlLine {
+    text: string;
+    eol: string;
+}
 export declare function patchCodexDefaultModeUserInputFeature(content: string): string;
-export declare function writeCodexConfigMerge(options: {
+export interface CodexManagedConfigOptions {
+    pluginId?: string;
+    manageThreads?: boolean;
+    priorThreadsValue?: string | null;
+    trustedHooks?: Record<string, string>;
+}
+/** Locate a scalar by its semantic TOML path, accepting quoted and dotted keys.
+ * Never serialize the document: all bytes outside the selected value survive.
+ */
+export declare function scalarLocation(content: string, path: string[]): {
+    lines: TomlLine[];
+    match: {
+        index: number;
+        prefix: string;
+        value: string;
+        suffix: string;
+    };
+    sectionStart: number;
+    sectionEnd: number;
+    insertionSection: {
+        path: string[];
+        start: number;
+        end: number;
+    };
+};
+export declare function readCodexThreadsValue(content: string): string | null;
+export declare function patchScalar(content: string, path: string[], value: string): string;
+export declare function writeCodexConfigMerge(options: CodexManagedConfigOptions & {
     configPath: string;
     dryRun?: boolean;
-    pluginId?: string;
 }): CodexConfigMergeResult;
 export {};

package/dist/cli/codex-hook-consent.d.ts

@@ -0,0 +1,5 @@
+export declare const CODEX_HOOK_CONSENT_PROMPT = "Trust thoth-agents SessionStart and SubagentStart hooks? Trusted hooks can run outside the sandbox. [y/N] ";
+export declare function requestCodexHookConsent(options: {
+    trustHooks?: boolean;
+    dryRun?: boolean;
+}): Promise<boolean>;

package/dist/cli/codex-hook-trust.d.ts

@@ -0,0 +1,23 @@
+interface CommandHandler {
+    type: string;
+    command: string;
+    commandWindows?: string | null;
+    timeout?: number | null;
+    async?: boolean;
+    statusMessage?: string | null;
+    additionalContextLimit?: number | null;
+}
+interface HookGroup {
+    matcher?: string | null;
+    hooks: CommandHandler[];
+}
+export interface CodexHookDeclarations {
+    hooks: Record<string, HookGroup[]>;
+}
+/** Version-coupled to rust-v0.162.1 discovery.rs / fingerprint.rs.
+ * Identity is flattened, includes one handler, and omits TOML None values.
+ * Commands are hashed before PLUGIN_ROOT substitution, after platform selection.
+ */
+export declare function codexHookTrustEntries(declarations: CodexHookDeclarations, source: string, platform: NodeJS.Platform): Record<string, string>;
+export declare function codexHookSource(pluginId?: string): string;
+export {};

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

@@ -1,17 +1,16 @@
 import type { CodexInstallScope, CodexRoleName } from './codex-paths';
+import { type CodexHookCapabilityConfig } from './codex-plugin-install';
 import { type ManagedModelState } from './managed-state-io';
 export { CODEX_ROLE_NAMES } from './codex-paths';
-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 CodexSetupAction = 'remove-legacy-root-block' | 'write-role-toml' | 'preserve-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 {
+export interface CodexInstallConfig extends CodexHookCapabilityConfig {
     dryRun?: boolean;
     reset: boolean;
     scope: CodexInstallScope;
-    projectRoot: string;
-    homeDir?: string;
-    codexHome?: string;
     packageRoot?: string;
-    pluginId?: string;
+    trustHooks?: boolean;
+    replaceLegacyAgents?: boolean;
 }
 export interface CodexSetupPlanItem {
     kind: CodexTargetKind;
@@ -25,8 +24,12 @@ export interface CodexSetupPlanItem {
     /** Apply-time guard captured while planning. */
     expectedContent?: string;
     expectedAbsent?: boolean;
+    /** Raw legacy file bytes: never decode/re-encode operator content. */
+    legacyRootBytes?: Buffer;
+    remainingRootBytes?: Buffer;
 }
 export interface CodexSetupPlan {
+    hookCapabilityConfig: CodexHookCapabilityConfig;
     dryRun: boolean;
     reset: boolean;
     items: CodexSetupPlanItem[];
@@ -34,6 +37,8 @@ export interface CodexSetupPlan {
     disclaimers: string[];
     configPath: string;
     pluginId?: string;
+    trustHooks?: boolean;
+    priorThreadsValue?: string | null;
 }
 export interface CodexApplyResult {
     success: boolean;
@@ -42,6 +47,12 @@ export interface CodexApplyResult {
     error?: string;
 }
 export declare const MANAGED_MODEL_STATE_VERSION = 1;
+export declare function roleStructureFingerprint(content: string): string;
+/** A recovery candidate, NOT proof of ownership. Only an explicit opt-in may replace it.
+ * Historical descriptions/routing changed: match the stable responsibility prefix,
+ * role envelope and Codex operational marker rather than a whole prompt digest.
+ */
+export declare function isMigratableLegacyRole(content: string, role: CodexRoleName): boolean;
 export declare function readManagedModelState(path: string): ManagedModelState;
 export declare function parseRoleTomlModel(content: string): string | undefined;
 export declare function replaceRoleTomlModel(content: string, model: string): string;
@@ -56,6 +67,10 @@ export interface CodexManagedModelOverride {
     clearEffort?: boolean;
 }
 export declare function applyCodexManagedModelOverrides(config: CodexInstallConfig, overrides: CodexManagedModelOverride[]): CodexApplyResult;
+export declare function planLegacyRootRemoval(path: string): {
+    items: CodexSetupPlanItem[];
+    diagnostics: string[];
+};
 export declare function buildCodexSetupPlan(config: CodexInstallConfig): CodexSetupPlan;
 export declare function formatCodexSetupPlan(plan: CodexSetupPlan): string;
 export declare function applyCodexSetup(plan: CodexSetupPlan): CodexApplyResult;

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

@@ -0,0 +1,13 @@
+import { type CodexHookCapabilityConfig } from './codex-plugin-install';
+import type { CodexOperationContext } from './operations/codex';
+export interface CodexLifecycleContext extends CodexOperationContext {
+    pluginId?: string;
+    localPluginBundlePath?: CodexHookCapabilityConfig['localPluginBundlePath'];
+    nodeAvailable?: () => boolean;
+}
+export interface CodexLifecycleResult {
+    success: boolean;
+    messages: string[];
+}
+export declare function uninstallCodex(context: CodexLifecycleContext, dryRun?: boolean): CodexLifecycleResult;
+export declare function doctorCodex(context: CodexLifecycleContext): CodexLifecycleResult;

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

@@ -1,3 +1,4 @@
+export declare const CODEX_PLUGIN_ID = "thoth-agents@thoth-plugins";
 export type CodexPluginSetupAction = 'register-marketplace' | 'install-plugin';
 export type CodexPluginCleanupAction = 'remove-legacy-plugin' | 'remove-legacy-marketplace' | 'remove-legacy-root';
 export interface CodexLegacyCleanupRoot {
@@ -60,6 +61,26 @@ export interface CodexPluginApplyResult {
     error?: string;
 }
 export declare function getCodexCommand(args: readonly string[], options?: CodexCommandInvocationOptions): CodexCommandInvocation;
+export declare function defaultCommandExecutor(command: string, args: readonly string[], options: CodexCommandOptions): CodexCommandResult;
+export interface CodexHookCapabilityConfig {
+    pluginId?: string;
+    /** Local development only: verify the synchronized bundle, not manager selection.
+     * Selection remains a separately reported warning in setup-codex-local.
+     */
+    localPluginBundlePath?: string;
+    codexHome?: string;
+    homeDir?: string;
+    projectRoot: string;
+    commandExecutor?: CodexCommandExecutor;
+}
+export interface CodexHookCapabilityResult {
+    success: boolean;
+    diagnostics: string[];
+    error?: string;
+    bundlePath?: string;
+}
+/** Shared migration prerequisite; hook trust is deliberately not inspected. */
+export declare function checkCodexHookCapability(config: CodexHookCapabilityConfig): CodexHookCapabilityResult;
 export declare function buildCodexPluginSetupPlan(config: CodexPluginInstallConfig): CodexPluginSetupPlan;
 export declare function applyCodexPluginSetup(plan: CodexPluginSetupPlan): CodexPluginApplyResult;
 export declare function formatCodexPluginSetupPlan(plan: CodexPluginSetupPlan): string;