moadim 1.1.0

Loop engine for AI agents — routines over REST, MCP, and a built-in web UI
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

//! Generates `schemas/routine.schema.json` and `schemas/routine.example.toml`.
//!
//! A `routine.toml` is normally written by the daemon (one folder per routine under the config
//! tree), but a committed JSON Schema gives editors validation/completion and documents the
//! on-disk shape. The shape tracks the `RoutineToml` serializer in `src/routine_storage.rs`.

use serde_json::{json, to_string_pretty};
use std::fs;
use std::path::Path;

/// Write the routine JSON Schema and an example TOML file into `<manifest_dir>/schemas/`.
pub fn generate(manifest_dir: &str) {
    let schema_dir = Path::new(manifest_dir).join("schemas");
    fs::create_dir_all(&schema_dir).expect("failed to create schemas/");

    let routine_schema = json!({
        "$schema": "https://json-schema.org/draft-07/schema#",
        "title": "Routine",
        "description": "A scheduled AI-agent task. Normally written and maintained by the daemon (one routine.toml per routine); this schema documents its on-disk shape and powers editor validation. Runtime trigger state lives in a gitignored state.local.toml sidecar, not here.",
        "type": "object",
        "required": ["schedule", "title", "agent", "prompt"],
        "properties": {
            "id": {
                "type": "string",
                "description": "UUID v4 uniquely identifying the routine, stable across renames. Assigned by the daemon on create."
            },
            "schedule": {
                "type": "string",
                "description": "Cron expression for when the routine runs, evaluated in the host's local system timezone (the OS crontab timezone), not UTC.",
                "examples": ["@hourly", "@daily", "30 9 * * 1-5"]
            },
            "title": {
                "type": "string",
                "description": "Human name; slugified to name the workbench folder and tmux session."
            },
            "agent": {
                "type": "string",
                "description": "Agent registry key (e.g. \"claude\") resolved from the agents config directory."
            },
            "prompt": {
                "type": "string",
                "description": "Task prompt handed to the agent."
            },
            "repositories": {
                "type": "array",
                "description": "Git repositories listed to the agent as prompt context (not cloned by moadim).",
                "items": {
                    "type": "object",
                    "required": ["repository"],
                    "properties": {
                        "repository": {
                            "type": "string",
                            "description": "Git remote URL."
                        },
                        "branch": {
                            "type": "string",
                            "description": "Branch to use; omit for the remote default branch."
                        }
                    },
                    "additionalProperties": false
                }
            },
            "enabled": {
                "type": "boolean",
                "description": "Whether the routine is active.",
                "default": true
            },
            "created_at": {
                "type": "integer",
                "minimum": 0,
                "description": "Unix timestamp (seconds) when the routine was created. Daemon-assigned."
            },
            "updated_at": {
                "type": "integer",
                "minimum": 0,
                "description": "Unix timestamp (seconds) when the routine was last updated. Daemon-assigned."
            },
            "ttl_secs": {
                "type": "integer",
                "minimum": 0,
                "description": "Workbench retention (seconds) for finished runs; caps the cron-derived retention lower. Absent uses the daemon default."
            },
            "max_runtime_secs": {
                "type": "integer",
                "minimum": 0,
                "description": "Max wall-clock seconds a single run may execute before the watchdog kills its hung session. Absent uses the daemon default."
            },
            "last_triggered_at": {
                "type": "integer",
                "minimum": 0,
                "description": "Legacy/read-only. Pre-rename last-manual-trigger timestamp; migrated into the state.local.toml sidecar on the next write and never written back. Accepted only so routine.toml files from older daemons still load."
            },
            "last_manual_trigger_at": {
                "type": "integer",
                "minimum": 0,
                "description": "Legacy/read-only. Last-manual-trigger timestamp; runtime trigger state now lives in the gitignored state.local.toml sidecar and is never written to routine.toml."
            }
        },
        "additionalProperties": false
    });

    fs::write(
        schema_dir.join("routine.schema.json"),
        to_string_pretty(&routine_schema).expect("failed to serialize routine schema"),
    )
    .expect("failed to write schemas/routine.schema.json");

    let example_toml = concat!(
        "#:schema ./routine.schema.json\n",
        "\n",
        "schedule = \"30 9 * * 1-5\"\n",
        "title    = \"My routine\"\n",
        "agent    = \"claude\"\n",
        "prompt   = \"Describe the task for the agent here.\"\n",
        "enabled  = true\n",
        "\n",
        "# Repositories listed to the agent as prompt context (optional).\n",
        "# [[repositories]]\n",
        "# repository = \"https://github.com/owner/repo\"\n",
        "# branch     = \"main\"\n",
    );
    fs::write(schema_dir.join("routine.example.toml"), example_toml)
        .expect("failed to write schemas/routine.example.toml");
}