schedule_create

Create future work only when requested. It runs with this authenticated owner’s current permissions and delivers its result in this channel. Daily/weekly schedules follow local wall time through DST. Missed recurring occurrences coalesce into one run. Interrupted or uncertain runs pause rather than replay.

User guide / All capabilities

Contract

Effect: write. Evidence role: discovery_only.

Schedule future work.

Parameters

This is the current provider-facing JSON Schema, generated from the runtime definition.

{
  "type": "object",
  "properties": {
    "notification_policy": {
      "type": "string",
      "enum": [
        "always",
        "conditional"
      ],
      "description": "Use conditional for monitoring: keep quiet when the prompt's condition has no reportable change. Failures and required action remain reportable. Default always."
    },
    "name": {
      "type": "string"
    },
    "prompt": {
      "type": "string",
      "description": "The complete future task and what should be delivered here. This approval covers the scheduled result message, not arbitrary future mutations."
    },
    "cadence": {
      "type": "string",
      "enum": [
        "once",
        "interval",
        "daily",
        "weekly"
      ]
    },
    "timezone": {
      "type": "string",
      "description": "IANA timezone, e.g. Europe/Lisbon."
    },
    "first_run_at": {
      "type": "string",
      "description": "ISO timestamp with UTC offset. Required for once/interval."
    },
    "interval_minutes": {
      "type": "number"
    },
    "local_time": {
      "type": "string",
      "description": "HH:mm, required for daily/weekly."
    },
    "weekday": {
      "type": "number",
      "description": "1–7, Monday–Sunday, required for weekly."
    }
  },
  "required": [
    "name",
    "prompt",
    "cadence",
    "timezone"
  ]
}

Execution requirements

The ordinary admission and tool execution checks apply.

Expected postconditions

Inspect the returned status, summary and data; do not infer success from a tool call alone.