| name | cron-schedule |
| description | Manage Gateway cron jobs (status/list/add/update/remove/run/runs) and send wake events. |
| metadata | {"CARNELIAN":{"emoji":"⏰","requires":{"env":["GATEWAY_URL","GATEWAY_TOKEN"]},"primaryEnv":"GATEWAY_URL"},"carnelian":{"runtime":"node","version":"1.0.0","sandbox":{"network":"localhost","resourceLimits":{"maxMemoryMB":64,"maxCpuPercent":10,"timeoutSecs":15},"env":{"GATEWAY_URL":"${GATEWAY_URL}","GATEWAY_TOKEN":"${GATEWAY_TOKEN}"}},"capabilities":["net.ws"]}} |
cron-schedule
Manage Gateway cron jobs (status/list/add/update/remove/run/runs) and send wake events.
Ported from CARNELIAN cron-tool.ts.
Input
{
action: string;
job?: object;
jobId?: string;
patch?: object;
text?: string;
mode?: string;
}
Supported Actions
| Action | Description | Required Fields |
|---|
status | Get cron system status | - |
list | List all cron jobs | - |
add | Add new cron job | job |
update | Update existing job | jobId, patch |
remove | Remove cron job | jobId |
run | Trigger job execution | jobId |
runs | Get job execution history | jobId |
wake | Send wake event | text |
Job Schema
{
schedule: {
kind: "at" | "every" | "cron";
value: string;
};
payload: {
kind: "systemEvent" | "agentTurn";
};
sessionTarget: "main" | "isolated";
}
Session Target Constraints
main session → systemEvent payload only
isolated session → agentTurn payload only
Output
Returns JSON response from the gateway.
Notes
- CARNELIAN dependency: The CARNELIAN gateway must be running
- Default gateway URL:
ws://127.0.0.1:18789
- No npm packages needed in the wrapper
- Uses WebSocket JSON-RPC for communication