feat(cron): add scheduler status endpoint

src/gateway/protocol/index.ts

@@ -22,6 +22,8 @@ import {
   CronRunParamsSchema,
   type CronRunsParams,
   CronRunsParamsSchema,
+  type CronStatusParams,
+  CronStatusParamsSchema,
   type CronUpdateParams,
   CronUpdateParamsSchema,
   ErrorCodes,
@@ -74,6 +76,9 @@ export const validateAgentParams = ajv.compile(AgentParamsSchema);
 export const validateWakeParams = ajv.compile<WakeParams>(WakeParamsSchema);
 export const validateCronListParams =
   ajv.compile<CronListParams>(CronListParamsSchema);
+export const validateCronStatusParams = ajv.compile<CronStatusParams>(
+  CronStatusParamsSchema,
+);
 export const validateCronAddParams =
   ajv.compile<CronAddParams>(CronAddParamsSchema);
 export const validateCronUpdateParams = ajv.compile<CronUpdateParams>(
@@ -115,6 +120,7 @@ export {
   WakeParamsSchema,
   CronJobSchema,
   CronListParamsSchema,
+  CronStatusParamsSchema,
   CronAddParamsSchema,
   CronUpdateParamsSchema,
   CronRemoveParamsSchema,
@@ -148,6 +154,7 @@ export type {
   WakeParams,
   CronJob,
   CronListParams,
+  CronStatusParams,
   CronAddParams,
   CronUpdateParams,
   CronRemoveParams,

src/gateway/protocol/schema.ts

@@ -316,6 +316,11 @@ export const CronListParamsSchema = Type.Object(
   { additionalProperties: false },
 );
 
+export const CronStatusParamsSchema = Type.Object(
+  {},
+  { additionalProperties: false },
+);
+
 export const CronAddParamsSchema = Type.Object(
   {
     name: Type.Optional(Type.String()),
@@ -438,6 +443,7 @@ export const ProtocolSchemas: Record<string, TSchema> = {
   WakeParams: WakeParamsSchema,
   CronJob: CronJobSchema,
   CronListParams: CronListParamsSchema,
+  CronStatusParams: CronStatusParamsSchema,
   CronAddParams: CronAddParamsSchema,
   CronUpdateParams: CronUpdateParamsSchema,
   CronRemoveParams: CronRemoveParamsSchema,
@@ -467,6 +473,7 @@ export type AgentEvent = Static<typeof AgentEventSchema>;
 export type WakeParams = Static<typeof WakeParamsSchema>;
 export type CronJob = Static<typeof CronJobSchema>;
 export type CronListParams = Static<typeof CronListParamsSchema>;
+export type CronStatusParams = Static<typeof CronStatusParamsSchema>;
 export type CronAddParams = Static<typeof CronAddParamsSchema>;
 export type CronUpdateParams = Static<typeof CronUpdateParamsSchema>;
 export type CronRemoveParams = Static<typeof CronRemoveParamsSchema>;

src/gateway/server.ts

@@ -76,6 +76,7 @@ import {
   validateCronRemoveParams,
   validateCronRunParams,
   validateCronRunsParams,
+  validateCronStatusParams,
   validateCronUpdateParams,
   validateRequestFrame,
   validateSendParams,
@@ -96,6 +97,7 @@ const METHODS = [
   "set-heartbeats",
   "wake",
   "cron.list",
+  "cron.status",
   "cron.add",
   "cron.update",
   "cron.remove",
@@ -1116,6 +1118,23 @@ export async function startGatewayServer(
             respond(true, { jobs }, undefined);
             break;
           }
+          case "cron.status": {
+            const params = (req.params ?? {}) as Record<string, unknown>;
+            if (!validateCronStatusParams(params)) {
+              respond(
+                false,
+                undefined,
+                errorShape(
+                  ErrorCodes.INVALID_REQUEST,
+                  `invalid cron.status params: ${formatValidationErrors(validateCronStatusParams.errors)}`,
+                ),
+              );
+              break;
+            }
+            const status = await cron.status();
+            respond(true, status, undefined);
+            break;
+          }
           case "cron.add": {
             const params = (req.params ?? {}) as Record<string, unknown>;
             if (!validateCronAddParams(params)) {