Plan Mode

The Swift SDK does not expose a separate CLI-style plan-mode flag because it is an in-process agent package. Use a planning-oriented Agent and a plan-and-execute loop strategy for read-first workflows.

let planner = Agent(
    name: "Planner",
    instructions: "Inspect and produce a plan. Do not modify files.",
    tools: [.readFile, .gitStatus, .gitDiff],
    loopType: .planAndExecute,
    model: ModelID("gpt-4o"),
    provider: provider,
    cwd: projectPath
)

let plan = try await Runner.runSync(
    agent: planner,
    prompt: "Plan this refactor",
    options: .init(maxPlanningSteps: 4)
)

PlanAndExecuteStrategy consumes maxPlanningSteps; ParallelStrategy consumes maxParallelCalls; and ReflexionStrategy consumes reflectionSteps and qualityThreshold. These per-run values override initializer defaults and are present in the prompt actually sent to the provider.

Review the plan in your host, then create an implementation agent with write tools enabled.