import { ErrorCategory } from "./error-category.type.mjs";
import { AIErrorOptions } from "./ai-error.mjs";
import { PlannerFailedError } from "./planner-failed-error.mjs";

//#region ../ai/src/errors/planner-cancelled-error.d.ts
/**
 * Options for {@link PlannerCancelledError}. Carries the observation
 * timestamp and the optional `controller.abort(reason)` payload.
 */
type PlannerCancelledErrorOptions = AIErrorOptions & {
  /** ISO-8601 timestamp at which the abort was observed by the planner. */cancelledAt: string; /** `controller.abort(reason)` payload when the caller supplied one. */
  reason?: string;
};
/**
 * Planner run was cancelled via `AbortSignal` before it could finish.
 * Between-step cancellation is guaranteed; mid-step cancellation is
 * best-effort (the signal is threaded into every in-flight capability
 * `execute()` call, but effectiveness depends on the child primitive
 * respecting it).
 *
 * On cancellation the planner returns normally with
 * `report.status === "cancelled"` and the partial step snapshots — the
 * error is placed on `result.error` rather than thrown.
 */
declare class PlannerCancelledError extends PlannerFailedError {
  static readonly defaultCategory: ErrorCategory;
  readonly cancelledAt: string;
  readonly reason?: string;
  constructor(message: string, options: PlannerCancelledErrorOptions);
}
//#endregion
export { PlannerCancelledError, PlannerCancelledErrorOptions };
//# sourceMappingURL=planner-cancelled-error.d.mts.map