Củng cố Cron Add & Căn chỉnh Schema

Ngữ cảnh

Log gateway gần đây cho thấy lỗi cron.add lặp lại với tham số không hợp lệ (thiếu sessionTarget, wakeMode, payload và schedule sai định dạng). Điều này cho thấy ít nhất một client (có thể là đường dẫn gọi công cụ agent) đang gửi payload công việc được bọc hoặc được chỉ định một phần. Riêng biệt, có sự trôi dạt giữa enum provider cron trong TypeScript, schema gateway, flag CLI và kiểu form UI, cộng sự không khớp UI cho cron.status (mong đợi jobCount trong khi gateway trả về jobs).

Mục tiêu

  • Dừng spam INVALID_REQUEST cron.add bằng cách chuẩn hóa payload wrapper phổ biến và suy ra trường kind thiếu.
  • Căn chỉnh danh sách provider cron qua schema gateway, kiểu cron, tài liệu CLI và form UI.
  • Làm rõ ràng schema công cụ cron agent để LLM tạo payload công việc đúng.
  • Sửa hiển thị số lượng công việc trạng thái cron Control UI.
  • Thêm test để bao phủ chuẩn hóa và hành vi công cụ.

Ngoài phạm vi

  • Thay đổi ngữ nghĩa lập lịch cron hoặc hành vi thực thi công việc.
  • Thêm loại lịch trình mới hoặc phân tích biểu thức cron.
  • Đại tu UI/UX cho cron ngoài các sửa trường cần thiết.

Phát hiện (khoảng trống hiện tại)

  • CronPayloadSchema trong gateway loại trừ signal + imessage, trong khi kiểu TS bao gồm chúng.
  • Control UI CronStatus mong đợi jobCount, nhưng gateway trả về jobs.
  • Schema công cụ cron agent cho phép đối tượng job tùy ý, cho phép input sai định dạng.
  • Gateway xác thực nghiêm ngặt cron.add không có chuẩn hóa, vì vậy payload được bọc thất bại.

Điều gì đã thay đổi

  • cron.add và cron.update bây giờ chuẩn hóa shape wrapper phổ biến và suy ra trường kind thiếu.
  • Schema công cụ cron agent khớp schema gateway, giảm payload không hợp lệ.
  • Enum provider được căn chỉnh qua gateway, CLI, UI và picker macOS.
  • Control UI sử dụng trường số lượng jobs của gateway cho trạng thái.

Hành vi hiện tại

  • Chuẩn hóa: payload data/job được bọc được mở bọc; schedule.kind và payload.kind được suy ra khi an toàn.
  • Mặc định: mặc định an toàn được áp dụng cho wakeMode và sessionTarget khi thiếu.
  • Provider: Discord/Slack/Signal/iMessage bây giờ được hiển thị nhất quán qua CLI/UI.

Xem Công việc cron cho shape chuẩn hóa và ví dụ.

Xác minh

  • Xem log gateway để giảm lỗi INVALID_REQUEST cron.add.
  • Xác nhận Control UI trạng thái cron hiển thị số lượng công việc sau khi làm mới.

Follow-up tùy chọn

  • Smoke thủ công Control UI: thêm công việc cron mỗi provider + xác minh số lượng công việc trạng thái.

Câu hỏi mở

  • cron.add nên chấp nhận state rõ ràng từ client (hiện bị schema không cho phép)?
  • Chúng ta nên cho phép webchat như provider giao hàng rõ ràng (hiện được lọc trong giải quyết giao hàng)?