@open-agent-toolkit/cli 0.1.45 → 0.1.48

package/dist/config/dispatch-policy-options.js

@@ -0,0 +1,96 @@
+import { dispatchPolicyProviderTargets, } from './dispatch-ceiling-preset.js';
+import { VALID_MANAGED_DISPATCH_POLICIES, } from './oat-config.js';
+const MANAGED_POLICY_DESCRIPTIONS = {
+    economy: 'Managed capped policy for lower-cost implementation and review dispatch.',
+    balanced: 'Managed capped policy for normal implementation and review dispatch.',
+    high: 'Managed capped policy for broad or higher-risk implementation and review dispatch.',
+    frontier: 'Managed capped policy for highest-tier implementation and review dispatch.',
+    uncapped: 'OAT still manages dispatch selection, but stores no maximum cap. The implementer can choose the preferred model/effort for the task. This is not host default behavior.',
+};
+const MANAGED_POLICY_LABELS = {
+    economy: 'Economy',
+    balanced: 'Balanced',
+    high: 'High',
+    frontier: 'Frontier',
+    uncapped: 'Uncapped',
+};
+function isCappedManagedPolicy(policy) {
+    return policy !== 'uncapped';
+}
+function managedChoice(policy) {
+    if (isCappedManagedPolicy(policy)) {
+        return {
+            value: policy,
+            label: MANAGED_POLICY_LABELS[policy],
+            kind: 'managed-capped',
+            runtimePolicy: true,
+            description: MANAGED_POLICY_DESCRIPTIONS[policy],
+            policy,
+            providers: dispatchPolicyProviderTargets(policy),
+        };
+    }
+    return {
+        value: policy,
+        label: MANAGED_POLICY_LABELS[policy],
+        kind: 'managed-uncapped',
+        runtimePolicy: true,
+        description: MANAGED_POLICY_DESCRIPTIONS[policy],
+        policy,
+    };
+}
+export function getDispatchPolicyChoices() {
+    return [
+        ...VALID_MANAGED_DISPATCH_POLICIES.map(managedChoice),
+        {
+            value: 'inherit',
+            label: 'Inherit Host Defaults',
+            kind: 'inherit',
+            runtimePolicy: true,
+            description: 'OAT does not choose model or effort. Subagents use the current host/provider default behavior, such as parent session model, base Codex role defaults, or provider config.',
+        },
+        {
+            value: 'leave-unresolved',
+            label: 'Leave Unresolved',
+            kind: 'unresolved',
+            runtimePolicy: false,
+            description: 'Planning records no policy as a planning/preflight deferral. Implementation preflight must block until a policy is configured or explicitly selected.',
+        },
+    ];
+}
+export function managedDispatchPolicyValueList(separator = ' | ') {
+    return VALID_MANAGED_DISPATCH_POLICIES.join(separator);
+}
+export function dispatchPolicyModeDescription() {
+    return [
+        'Dispatch policy mode.',
+        '"managed" means OAT selects model/effort from workflow.dispatchPolicy.policy.',
+        '"inherit" leaves dispatch controls to host/provider defaults.',
+        'Resolution: local > shared > user > default.',
+    ].join(' ');
+}
+export function dispatchPolicyPolicyDescription() {
+    return [
+        'Managed dispatch policy.',
+        'economy, balanced, high, and frontier are capped managed policies.',
+        'uncapped keeps OAT-managed preferred selection without provider caps.',
+        'inherit leaves dispatch controls to host/provider defaults through workflow.dispatchPolicy.mode.',
+        'Setting this key writes workflow.dispatchPolicy.mode=managed.',
+        'Resolution: local > shared > user > default.',
+    ].join(' ');
+}
+function providerSummary(choice) {
+    return choice.providers
+        ? `Codex: ${choice.providers.codex}; Claude: ${choice.providers.claude}`
+        : choice.kind === 'managed-uncapped'
+            ? 'No stored maximum cap'
+            : choice.kind === 'inherit'
+                ? 'Host/provider defaults'
+                : 'No runtime policy';
+}
+export function renderDispatchPolicyChoicesMarkdown(choices = getDispatchPolicyChoices()) {
+    return [
+        'Set the dispatch policy - how OAT should choose subagent model/effort controls.',
+        '',
+        ...choices.map((choice, index) => `${index + 1}. ${choice.label} - ${providerSummary(choice)}. ${choice.description}`),
+    ].join('\n');
+}

package/dist/config/oat-config.d.ts

@@ -20,7 +20,7 @@ export type WorkflowHillCheckpointDefault = 'every' | 'final';
 export type WorkflowPostImplementSequence = 'wait' | 'summary' | 'pr' | 'docs-pr';
 export type WorkflowReviewExecutionModel = 'subagent' | 'inline' | 'fresh-session';
 export type WorkflowDesignMode = 'collaborative' | 'selective' | 'draft';
-export type WorkflowCodexDispatchCeiling = 'low' | 'medium' | 'high' | 'xhigh';
+export type WorkflowCodexDispatchCeiling = 'low' | 'medium' | 'high' | 'xhigh' | 'max';
 export type WorkflowClaudeDispatchCeiling = 'haiku' | 'sonnet' | 'opus' | 'fable';
 export type WorkflowDispatchCeilingPreset = 'balanced' | 'maximum' | 'cost-conscious';
 export type WorkflowDispatchPolicyMode = 'managed' | 'inherit';
@@ -31,9 +31,21 @@ export interface WorkflowDispatchRouteTarget {
     model?: string;
     effort?: string;
 }
+export interface DispatchRouteTargetValidation {
+    valid: boolean;
+    reason?: string;
+}
 export type WorkflowDispatchRouteEntry = string | WorkflowDispatchRouteTarget;
 export type WorkflowDispatchRoute = WorkflowDispatchRouteEntry[];
-export type WorkflowDispatchMatrixCell = string | WorkflowDispatchRoute;
+export interface WorkflowDispatchFallbackRoute {
+    route: WorkflowDispatchRoute;
+}
+export type WorkflowDispatchCandidate = WorkflowDispatchRouteEntry | WorkflowDispatchFallbackRoute;
+export interface WorkflowDispatchCandidateLadder {
+    candidates: WorkflowDispatchCandidate[];
+}
+export type WorkflowDispatchLegacyMatrixCell = string | WorkflowDispatchRoute;
+export type WorkflowDispatchMatrixCell = WorkflowDispatchCandidateLadder | WorkflowDispatchLegacyMatrixCell;
 export type WorkflowDispatchProviderValue = string | Partial<Record<WorkflowDispatchMatrixTier, WorkflowDispatchMatrixCell>>;
 export type GateOnFailure = 'block' | 'prompt' | 'warn';
 export type GateAvoid = 'same-family' | 'same-runtime' | 'none';
@@ -56,9 +68,14 @@ export interface GateConfig {
     description?: string;
     maxAttempts?: number;
 }
+export interface ExecTargetInvocation {
+    model?: string | 'provider-default';
+    reasoningEffort?: string | 'provider-default';
+}
 export interface ExecTarget {
     runtime: string;
     baseCommand: string[];
+    invocation?: ExecTargetInvocation;
     models?: string[];
     hostDetectionCommand?: string[];
     availabilityCommand?: string[];
@@ -90,6 +107,11 @@ export declare const VALID_DISPATCH_POLICY_MODES: readonly WorkflowDispatchPolic
 export declare const VALID_MANAGED_DISPATCH_POLICIES: readonly WorkflowManagedDispatchPolicy[];
 export declare const VALID_DISPATCH_MATRIX_TIERS: readonly WorkflowDispatchMatrixTier[];
 export declare const BUILTIN_EXEC_TARGETS: Readonly<Record<string, ExecTarget>>;
+export declare function isCodexMaterializedRouteTarget(provider: string, target: WorkflowDispatchRouteTarget): boolean;
+export declare function validateDispatchRouteTarget(provider: string, target: WorkflowDispatchRouteTarget): DispatchRouteTargetValidation;
+export declare function isWorkflowDispatchFallbackRoute(value: unknown): value is WorkflowDispatchFallbackRoute;
+export declare function isWorkflowDispatchCandidateLadder(value: unknown): value is WorkflowDispatchCandidateLadder;
+export declare function toWorkflowDispatchCandidateLadder(cell: WorkflowDispatchMatrixCell): WorkflowDispatchCandidateLadder;
 export type OatToolsConfig = Partial<Record<'core' | 'ideas' | 'docs' | 'workflows' | 'utility' | 'project-management' | 'research' | 'brainstorm', boolean>>;
 export interface OatConfig {
     version: number;
@@ -125,6 +147,7 @@ export interface ActiveProjectResolution {
     path: string | null;
     status: 'active' | 'missing' | 'unset';
 }
+export declare function normalizeProjectPath(repoRoot: string, pathValue: string | null | undefined): string | null;
 export declare function resolveLocalPaths(config: OatConfig): string[];
 export declare function readOatConfig(repoRoot: string): Promise<OatConfig>;
 export declare function readOatLocalConfig(repoRoot: string): Promise<OatLocalConfig>;

package/dist/config/oat-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"oat-config.d.ts","sourceRoot":"","sources":["../../src/config/oat-config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"oat-config.d.ts","sourceRoot":"","sources":["../../src/config/oat-config.ts"],"names":[],"mappings":"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"}

package/dist/config/oat-config.js

@@ -1,8 +1,8 @@
 import { execSync } from 'node:child_process';
-import { readFile } from 'node:fs/promises';
+import { lstat, readFile } from 'node:fs/promises';
 import { basename, isAbsolute, join, relative, resolve, sep } from 'node:path';
 import { atomicWriteJson, dirExists, fileExists } from '../fs/io.js';
-import { normalizeToPosixPath } from '../fs/paths.js';
+import { normalizeToPosixPath, validateRealPathWithinScope } from '../fs/paths.js';
 import { parseJsonConfig } from './json.js';
 const VALID_HILL_CHECKPOINT_DEFAULTS = ['every', 'final'];
 const VALID_POST_IMPLEMENT_SEQUENCES = ['wait', 'summary', 'pr', 'docs-pr'];
@@ -16,7 +16,7 @@ const VALID_DESIGN_MODES = [
     'selective',
     'draft',
 ];
-export const VALID_CODEX_DISPATCH_CEILINGS = ['low', 'medium', 'high', 'xhigh'];
+export const VALID_CODEX_DISPATCH_CEILINGS = ['low', 'medium', 'high', 'xhigh', 'max'];
 export const VALID_CLAUDE_DISPATCH_CEILINGS = ['haiku', 'sonnet', 'opus', 'fable'];
 export const VALID_DISPATCH_CEILING_PRESETS = ['balanced', 'maximum', 'cost-conscious'];
 export const VALID_DISPATCH_POLICY_MODES = ['managed', 'inherit'];
@@ -31,6 +31,10 @@ export const BUILTIN_EXEC_TARGETS = {
     'codex-default': {
         runtime: 'codex',
         baseCommand: ['codex', 'exec'],
+        invocation: {
+            model: 'provider-default',
+            reasoningEffort: 'provider-default',
+        },
         hostDetectionCommand: [
             'sh',
             '-c',
@@ -42,6 +46,10 @@ export const BUILTIN_EXEC_TARGETS = {
     'claude-default': {
         runtime: 'claude',
         baseCommand: ['claude', '-p'],
+        invocation: {
+            model: 'provider-default',
+            reasoningEffort: 'provider-default',
+        },
         hostDetectionCommand: ['sh', '-c', 'test -n "$CLAUDECODE"'],
         availabilityCommand: ['claude', '--version'],
         priority: 100,
@@ -49,6 +57,10 @@ export const BUILTIN_EXEC_TARGETS = {
     'cursor-default': {
         runtime: 'cursor',
         baseCommand: ['cursor-agent', '-p'],
+        invocation: {
+            model: 'provider-default',
+            reasoningEffort: 'provider-default',
+        },
         hostDetectionCommand: ['sh', '-c', 'test -n "$CURSOR_AGENT"'],
         availabilityCommand: [
             'sh',
@@ -58,6 +70,35 @@ export const BUILTIN_EXEC_TARGETS = {
         priority: 70,
     },
 };
+export function isCodexMaterializedRouteTarget(provider, target) {
+    return (target.harness ?? provider) === 'codex';
+}
+export function validateDispatchRouteTarget(provider, target) {
+    if (!isCodexMaterializedRouteTarget(provider, target)) {
+        return { valid: true };
+    }
+    if (!target.model || !target.effort) {
+        return {
+            valid: false,
+            reason: 'Codex materialized dispatch targets must provide both model and effort.',
+        };
+    }
+    return { valid: true };
+}
+export function isWorkflowDispatchFallbackRoute(value) {
+    return isRecord(value) && Array.isArray(value.route);
+}
+export function isWorkflowDispatchCandidateLadder(value) {
+    return isRecord(value) && Array.isArray(value.candidates);
+}
+export function toWorkflowDispatchCandidateLadder(cell) {
+    if (isWorkflowDispatchCandidateLadder(cell)) {
+        return cell;
+    }
+    return {
+        candidates: [Array.isArray(cell) ? { route: cell } : cell],
+    };
+}
 function normalizeMaxAttempts(value) {
     if (typeof value !== 'number' || !Number.isFinite(value)) {
         return 2;
@@ -143,11 +184,7 @@ function normalizeDispatchRouteTarget(value) {
     }
     return Object.keys(target).length > 0 ? target : undefined;
 }
-function normalizeDispatchMatrixCell(providerKey, value) {
-    const bareValue = normalizeProviderBareValue(providerKey, value);
-    if (bareValue !== undefined) {
-        return bareValue;
-    }
+function normalizeDispatchRoute(providerKey, value) {
     if (!Array.isArray(value) || value.length === 0) {
         return undefined;
     }
@@ -165,6 +202,39 @@ function normalizeDispatchMatrixCell(providerKey, value) {
     }
     return route.length > 0 ? route : undefined;
 }
+function normalizeDispatchCandidate(providerKey, value) {
+    const bareValue = normalizeProviderBareValue(providerKey, value);
+    if (bareValue !== undefined) {
+        return bareValue;
+    }
+    if (isRecord(value) && Object.hasOwn(value, 'route')) {
+        const route = normalizeDispatchRoute(providerKey, value.route);
+        return route ? { route } : undefined;
+    }
+    return normalizeDispatchRouteTarget(value);
+}
+function normalizeDispatchMatrixCell(providerKey, value) {
+    const bareValue = normalizeProviderBareValue(providerKey, value);
+    if (bareValue !== undefined) {
+        return { candidates: [bareValue] };
+    }
+    if (isWorkflowDispatchCandidateLadder(value)) {
+        const candidates = [];
+        for (const candidate of value.candidates) {
+            const normalized = normalizeDispatchCandidate(providerKey, candidate);
+            if (normalized !== undefined) {
+                candidates.push(normalized);
+            }
+        }
+        return candidates.length > 0 ? { candidates } : undefined;
+    }
+    const directTarget = normalizeDispatchRouteTarget(value);
+    if (directTarget !== undefined) {
+        return { candidates: [directTarget] };
+    }
+    const route = normalizeDispatchRoute(providerKey, value);
+    return route ? { candidates: [{ route }] } : undefined;
+}
 function normalizeDispatchProviderValue(providerKey, value) {
     const bareValue = normalizeProviderBareValue(providerKey, value);
     if (bareValue !== undefined) {
@@ -201,6 +271,16 @@ function normalizeExecTarget(value) {
     if (baseCommand !== undefined) {
         target.baseCommand = baseCommand;
     }
+    if (isRecord(value.invocation)) {
+        const model = trimNonEmptyString(value.invocation.model);
+        const reasoningEffort = trimNonEmptyString(value.invocation.reasoningEffort);
+        if (model !== undefined || reasoningEffort !== undefined) {
+            target.invocation = {
+                ...(model !== undefined ? { model } : {}),
+                ...(reasoningEffort !== undefined ? { reasoningEffort } : {}),
+            };
+        }
+    }
     const models = normalizeStringList(value.models);
     if (models !== undefined) {
         target.models = models;
@@ -390,7 +470,7 @@ function normalizeKnownStrays(value) {
         .filter((pathValue) => pathValue !== undefined);
     return normalized.length > 0 ? [...new Set(normalized)].sort() : undefined;
 }
-function normalizeProjectPath(repoRoot, pathValue) {
+export function normalizeProjectPath(repoRoot, pathValue) {
     if (pathValue == null) {
         return null;
     }
@@ -398,25 +478,42 @@ function normalizeProjectPath(repoRoot, pathValue) {
     if (!trimmed) {
         return null;
     }
-    if (!isAbsolute(trimmed)) {
-        const normalizedRelative = trimPathValue(normalizeToPosixPath(trimmed));
-        return normalizedRelative && normalizedRelative !== '.'
-            ? normalizedRelative
-            : null;
-    }
     const repoRootResolved = resolve(repoRoot);
-    const absoluteResolved = resolve(trimmed);
-    const isInsideRepo = absoluteResolved === repoRootResolved ||
-        absoluteResolved.startsWith(`${repoRootResolved}${sep}`);
+    const absoluteResolved = resolve(repoRootResolved, trimmed);
+    const relativePath = relative(repoRootResolved, absoluteResolved);
+    const isInsideRepo = !isAbsolute(relativePath) &&
+        relativePath !== '..' &&
+        !relativePath.startsWith(`..${sep}`);
     if (!isInsideRepo) {
         return null;
     }
-    const relativePath = normalizeToPosixPath(relative(repoRootResolved, absoluteResolved));
-    const normalizedRelative = trimPathValue(relativePath);
+    const normalizedRelative = trimPathValue(normalizeToPosixPath(relativePath));
     return normalizedRelative && normalizedRelative !== '.'
         ? normalizedRelative
         : null;
 }
+async function normalizeReadableProjectPath(repoRoot, pathValue) {
+    const normalizedPath = normalizeProjectPath(repoRoot, pathValue);
+    if (!normalizedPath) {
+        return null;
+    }
+    const absolutePath = join(repoRoot, normalizedPath);
+    try {
+        await lstat(absolutePath);
+    }
+    catch (error) {
+        return isMissingFileError(error) ? normalizedPath : null;
+    }
+    try {
+        const validated = await validateRealPathWithinScope(absolutePath, repoRoot);
+        return (await dirExists(validated.realPath))
+            ? normalizeProjectPath(validated.realScopeRoot, validated.realPath)
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
 function normalizeOatConfig(parsed) {
     const next = { ...DEFAULT_OAT_CONFIG };
     if (!isRecord(parsed)) {
@@ -583,7 +680,11 @@ export async function readOatLocalConfig(repoRoot) {
     const configPath = getLocalConfigPath(repoRoot);
     try {
         const raw = await readFile(configPath, 'utf8');
-        return normalizeOatLocalConfig(repoRoot, parseJsonConfig(raw, configPath));
+        const normalized = normalizeOatLocalConfig(repoRoot, parseJsonConfig(raw, configPath));
+        if (normalized.activeProject !== undefined) {
+            normalized.activeProject = await normalizeReadableProjectPath(repoRoot, normalized.activeProject);
+        }
+        return normalized;
     }
     catch (error) {
         if (isMissingFileError(error)) {
@@ -608,12 +709,29 @@ export async function resolveActiveProject(repoRoot) {
     if (!projectPath) {
         return { name: null, path: null, status: 'unset' };
     }
-    const absoluteProjectPath = join(repoRoot, projectPath);
+    let resolvedProjectPath = projectPath;
+    let absoluteProjectPath = join(repoRoot, projectPath);
+    try {
+        const validated = await validateRealPathWithinScope(absoluteProjectPath, repoRoot);
+        const canonicalProjectPath = normalizeProjectPath(validated.realScopeRoot, validated.realPath);
+        if (!canonicalProjectPath) {
+            throw new Error('Project path resolves to the repository root.');
+        }
+        resolvedProjectPath = canonicalProjectPath;
+        absoluteProjectPath = validated.realPath;
+    }
+    catch {
+        return {
+            name: basename(absoluteProjectPath),
+            path: projectPath,
+            status: 'missing',
+        };
+    }
     const statePath = join(absoluteProjectPath, 'state.md');
     const isValid = (await dirExists(absoluteProjectPath)) && (await fileExists(statePath));
     return {
         name: basename(absoluteProjectPath),
-        path: projectPath,
+        path: resolvedProjectPath,
         status: isValid ? 'active' : 'missing',
     };
 }
@@ -622,10 +740,22 @@ export async function setActiveProject(repoRoot, projectRelativePath) {
     if (!normalizedPath) {
         throw new Error(`Active project path must be repo-relative or inside repo root: ${projectRelativePath}`);
     }
+    let canonicalPath;
+    try {
+        const validated = await validateRealPathWithinScope(join(repoRoot, normalizedPath), repoRoot);
+        const canonicalProjectPath = normalizeProjectPath(validated.realScopeRoot, validated.realPath);
+        if (!canonicalProjectPath || !(await dirExists(validated.realPath))) {
+            throw new Error('Project directory is missing.');
+        }
+        canonicalPath = canonicalProjectPath;
+    }
+    catch {
+        throw new Error(`Active project path must be repo-relative or inside repo root: ${projectRelativePath}`);
+    }
     const localConfig = await readOatLocalConfig(repoRoot);
     await writeOatLocalConfig(repoRoot, {
         ...localConfig,
-        activeProject: normalizedPath,
+        activeProject: canonicalPath,
     });
 }
 export async function clearActiveProject(repoRoot, options) {

package/dist/config/resolve.d.ts

@@ -18,4 +18,12 @@ export interface ResolveEffectiveConfigDependencies {
 export declare function resolveEffectiveConfig(repoRoot: string, userConfigDir: string, env?: NodeJS.ProcessEnv, overrides?: Partial<ResolveEffectiveConfigDependencies>): Promise<ResolvedConfig>;
 export declare function resolveGate(effective: ResolvedConfig, skillName: string): GateConfig | null;
 export declare function resolveExecTargets(effective: ResolvedConfig): Record<string, ExecTarget>;
+export type ExecTargetOrigin = 'builtin' | 'user' | 'shared' | 'local';
+export interface ResolvedExecTargetView {
+    target: ExecTarget;
+    origin: ExecTargetOrigin;
+    explicitlyConfigured: boolean;
+    enabled: boolean;
+}
+export declare function resolveExecTargetViews(effective: ResolvedConfig): Record<string, ResolvedExecTargetView>;
 //# sourceMappingURL=resolve.d.ts.map

package/dist/config/resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/config/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,oBAAoB,GAC5B,QAAQ,GACR,OAAO,GACP,MAAM,GACN,KAAK,GACL,SAAS,CAAC;AAEd,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,cAAc,CAAC;IACtB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,kCAAkC;IACjD,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CAChE;AAmFD,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,SAAS,GAAE,OAAO,CAAC,kCAAkC,CAAM,GAC1D,OAAO,CAAC,cAAc,CAAC,CAgFzB;AAED,wBAAgB,WAAW,CACzB,SAAS,EAAE,cAAc,EACzB,SAAS,EAAE,MAAM,GAChB,UAAU,GAAG,IAAI,CAcnB;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,cAAc,GACxB,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAY5B"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/config/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,oBAAoB,GAC5B,QAAQ,GACR,OAAO,GACP,MAAM,GACN,KAAK,GACL,SAAS,CAAC;AAEd,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,cAAc,CAAC;IACtB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,kCAAkC;IACjD,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CAChE;AAmFD,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,SAAS,GAAE,OAAO,CAAC,kCAAkC,CAAM,GAC1D,OAAO,CAAC,cAAc,CAAC,CAgFzB;AAED,wBAAgB,WAAW,CACzB,SAAS,EAAE,cAAc,EACzB,SAAS,EAAE,MAAM,GAChB,UAAU,GAAG,IAAI,CAcnB;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,cAAc,GACxB,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAY5B;AAED,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEvE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,gBAAgB,CAAC;IACzB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,cAAc,GACxB,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAoDxC"}

package/dist/config/resolve.js

@@ -1,4 +1,4 @@
-import { BUILTIN_EXEC_TARGETS, readOatConfig, readOatLocalConfig, readUserConfig, } from './oat-config.js';
+import { BUILTIN_EXEC_TARGETS, isWorkflowDispatchCandidateLadder, readOatConfig, readOatLocalConfig, readUserConfig, } from './oat-config.js';
 const DEFAULT_DEPENDENCIES = {
     readOatConfig,
     readOatLocalConfig,
@@ -167,6 +167,53 @@ export function resolveExecTargets(effective) {
     }
     return targets;
 }
+export function resolveExecTargetViews(effective) {
+    const targets = cloneExecTargetRegistry(BUILTIN_EXEC_TARGETS);
+    const views = Object.fromEntries(Object.entries(targets).map(([id, target]) => [
+        id,
+        {
+            target: cloneExecTarget(target),
+            origin: 'builtin',
+            explicitlyConfigured: false,
+            enabled: true,
+        },
+    ]));
+    for (const [origin, layer] of [
+        ['user', effective.user.workflow?.gates?.execTargets],
+        ['shared', effective.shared.workflow?.gates?.execTargets],
+        ['local', effective.local.workflow?.gates?.execTargets],
+    ]) {
+        if (!layer) {
+            continue;
+        }
+        for (const [id, override] of Object.entries(layer)) {
+            if (override === null) {
+                const target = targets[id] ?? views[id]?.target;
+                delete targets[id];
+                if (target) {
+                    views[id] = {
+                        target: cloneExecTarget(target),
+                        origin,
+                        explicitlyConfigured: true,
+                        enabled: false,
+                    };
+                }
+                continue;
+            }
+            mergeExecTargetLayer(targets, { [id]: override });
+            const target = targets[id];
+            if (target) {
+                views[id] = {
+                    target: cloneExecTarget(target),
+                    origin,
+                    explicitlyConfigured: true,
+                    enabled: true,
+                };
+            }
+        }
+    }
+    return views;
+}
 function mergeExecTargetLayer(targets, layer) {
     if (!layer) {
         return;
@@ -181,6 +228,7 @@ function mergeExecTargetLayer(targets, layer) {
             targets[id] = cloneExecTarget({
                 runtime: override.runtime ?? existing.runtime,
                 baseCommand: override.baseCommand ?? existing.baseCommand,
+                invocation: mergeExecTargetInvocation(existing.invocation, override.invocation),
                 models: override.models ?? existing.models,
                 hostDetectionCommand: override.hostDetectionCommand ?? existing.hostDetectionCommand,
                 availabilityCommand: override.availabilityCommand ?? existing.availabilityCommand,
@@ -209,6 +257,9 @@ function cloneExecTarget(target) {
     if (target.hostDetectionCommand) {
         next.hostDetectionCommand = [...target.hostDetectionCommand];
     }
+    if (target.invocation) {
+        next.invocation = { ...target.invocation };
+    }
     if (target.availabilityCommand) {
         next.availabilityCommand = [...target.availabilityCommand];
     }
@@ -229,6 +280,9 @@ function toCompleteExecTarget(target) {
             ? target.priority
             : 0,
     };
+    if (target.invocation) {
+        completeTarget.invocation = { ...target.invocation };
+    }
     if (isValidArgv(target.hostDetectionCommand)) {
         completeTarget.hostDetectionCommand = [...target.hostDetectionCommand];
     }
@@ -240,6 +294,15 @@ function toCompleteExecTarget(target) {
     }
     return completeTarget;
 }
+function mergeExecTargetInvocation(existing, override) {
+    if (!existing && !override) {
+        return undefined;
+    }
+    return {
+        ...existing,
+        ...override,
+    };
+}
 function isValidStringList(value) {
     return (Array.isArray(value) &&
         value.length > 0 &&
@@ -264,7 +327,8 @@ function flattenConfig(value, prefix = '') {
             continue;
         }
         const nextKey = prefix ? `${prefix}.${key}` : key;
-        if (isRecord(nestedValue)) {
+        if (isRecord(nestedValue) &&
+            !isWorkflowDispatchCandidateLadder(nestedValue)) {
             Object.assign(flattened, flattenConfig(nestedValue, nextKey));
             continue;
         }

package/dist/engine/index.d.ts

@@ -5,5 +5,5 @@ export { configureLocalHooksPath, getHookInstallInfo, HOOK_DRIFT_WARNING, HOOK_M
 export type { HookInstallInfo, HookStatus } from './hook.js';
 export { hasMarker, insertMarker, OAT_DIRECTORY_SENTINEL, OAT_MARKER_PREFIX, writeDirectorySentinel, } from './markers.js';
 export type { CanonicalEntry } from './scanner.js';
-export { scanCanonical } from './scanner.js';
+export { scanBundledManagedCodexAgents, scanCanonical } from './scanner.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/engine/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,aAAa,GACd,MAAM,QAAQ,CAAC;AAChB,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,EACL,SAAS,EACT,YAAY,EACZ,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,aAAa,GACd,MAAM,QAAQ,CAAC;AAChB,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,EACL,SAAS,EACT,YAAY,EACZ,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,6BAA6B,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}

package/dist/engine/index.js

@@ -3,4 +3,4 @@ export { SYNC_OPERATION_TYPES, } from './engine.types.js';
 export { executeSyncPlan } from './execute-plan.js';
 export { configureLocalHooksPath, getHookInstallInfo, HOOK_DRIFT_WARNING, HOOK_MARKER_END, HOOK_MARKER_START, HOOK_STRAY_INFO, installHook, isHookInstalled, REPO_GITHOOKS_PATH, runHookCheck, uninstallHook, } from './hook.js';
 export { hasMarker, insertMarker, OAT_DIRECTORY_SENTINEL, OAT_MARKER_PREFIX, writeDirectorySentinel, } from './markers.js';
-export { scanCanonical } from './scanner.js';
+export { scanBundledManagedCodexAgents, scanCanonical } from './scanner.js';

package/dist/engine/scanner.d.ts

@@ -6,6 +6,7 @@ export interface CanonicalEntry {
     canonicalPath: string;
     isFile: boolean;
 }
+export declare function scanBundledManagedCodexAgents(): Promise<CanonicalEntry[]>;
 export declare function scanCanonical(basePath: string, scope: ConcreteScope): Promise<CanonicalEntry[]>;
 export {};
 //# sourceMappingURL=scanner.d.ts.map

package/dist/engine/scanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/engine/scanner.ts"],"names":[],"mappings":"AAIA,OAAO,EAAuB,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAEhE,KAAK,aAAa,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;CACjB;AA0DD,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,cAAc,EAAE,CAAC,CA2B3B"}
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/engine/scanner.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,KAAK,EACX,MAAM,eAAe,CAAC;AAEvB,KAAK,aAAa,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;CACjB;AA0DD,wBAAsB,6BAA6B,IAAI,OAAO,CAC5D,cAAc,EAAE,CACjB,CAsBA;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,cAAc,EAAE,CAAC,CA2B3B"}