import '../../data/catalog/catalog_repository.dart';
import '../../data/db/daos/habit_dao.dart';
import '../../data/db/daos/tracker_dao.dart';
import '../../domain/models/frame_pattern.dart';
import 'tool_envelope.dart';

/// Shared dependencies for every tool handler.
///
/// Frame patterns are passed in pre-loaded (memo'd at provider level) so the
/// R7 avoidance check doesn't reparse seed JSON on every tool call.
class ToolDeps {
  final HabitDao habitDao;
  final TrackerDao trackerDao;
  final CatalogRepository catalog;
  final List<FramePatternModel> framePatterns;
  final String userId;

  const ToolDeps({
    required this.habitDao,
    required this.trackerDao,
    required this.catalog,
    required this.framePatterns,
    required this.userId,
  });
}

typedef ToolHandler =
    Future<ToolResult> Function(Map<String, dynamic> args, ToolDeps deps);

/// Single tool the model can call.
///
/// `parametersSchema` follows the draft-07 JSON Schema shape that
/// flutter_gemma 0.16.5's `Tool.parameters` expects — see ADR-0005 (Dart is
/// the schema source-of-truth).
class ToolDefinition {
  final String name;
  final String description;
  final Map<String, dynamic> parametersSchema;
  final bool isDestructive;
  final ToolHandler handler;

  /// Optional summariser used by `ConfirmGate` to render destructive args in
  /// a sentence rather than raw JSON. Read-only tools leave this null.
  final String Function(Map<String, dynamic> args)? summarize;

  const ToolDefinition({
    required this.name,
    required this.description,
    required this.parametersSchema,
    required this.handler,
    this.isDestructive = false,
    this.summarize,
  });
}