/** * Planning mode for AgentTeam: `AgentTeam({ planning: true })`. * * Python parity: `AgentTeam._run_with_planning`. The team's task descriptions * are joined into one request, a PlanningAgent turns that into a Plan, the plan * is approved (or the run is abandoned), a TodoList tracks it, and the plan's * steps -- not the original tasks -- are what actually run. */ import { Plan, TodoList } from '../planning'; /** Python parity: MultiAgentPlanningConfig. */ export interface TeamPlanningSettings { /** Whether planning mode is on at all. */ enabled: boolean; /** Model the planner runs on. Python parity: planning_llm (default gpt-4o-mini). */ llm: string; /** Python parity: auto_approve_plan. */ autoApprove: boolean; /** Custom approval. Python parity: ApprovalCallback(approve_fn=...). */ approveFn?: (plan: Plan) => boolean | Promise; /** Called when a plan is rejected. Python parity: ApprovalCallback(on_reject=...). */ onReject?: (plan: Plan) => void; } /** The value `AgentTeam({ planning })` accepts. */ export type TeamPlanningInput = boolean | string | Partial> | [string, Partial>]; /** Resolve `planning` into planner settings. A string is the planner's model. */ export declare function resolveTeamPlanning(value: unknown): TeamPlanningSettings; /** * Ask the planner for a plan covering `request`. Returns null when the planner * produced no steps, which Python treats as "planning failed, fall back to * normal execution". */ export declare function createTeamPlan(settings: TeamPlanningSettings, request: string, verbose: boolean): Promise; /** * Decide whether the plan may run. * * Python parity: `ApprovalCallback.__call__` -- auto_approve wins, then a * custom approve_fn, then the interactivity rule: a non-interactive process * (CI, a script, a test) approves, an interactive one requires an explicit yes * and therefore rejects a plan nobody approved. */ export declare function approveTeamPlan(settings: TeamPlanningSettings, plan: Plan): Promise; /** The todo list Python builds from a plan so progress is trackable. */ export declare function todoListFromPlan(plan: Plan): TodoList;