openclaw-scheduler 0.2.9 → 0.2.10

package/migrate-consolidate.js

@@ -1,7 +1,7 @@
 /**
  * migrate-consolidate.js -- Single idempotent migration for existing databases
  *
- * Brings any DB from any prior version up to the current schema (v23).
+ * Brings any DB from any prior version up to the current schema (v24).
  * Fresh installs get everything from schema.sql directly -- this only
  * runs ALTER TABLEs needed for DBs created before the current schema.
  *
@@ -58,6 +58,7 @@ export default function migrateConsolidate() {
       'max_trigger_fanout', 'output_store_limit_bytes',
       'output_excerpt_limit_bytes', 'output_summary_limit_bytes',
       'output_offload_threshold_bytes', 'ttl_hours', 'auth_profile',
+      'payload_model_fallback', 'auth_profile_fallback',
       'schedule_kind', 'schedule_at', 'delivery_channel', 'delivery_to',
       'delivery_opt_out_reason', 'origin', 'parent_id', 'created_at',
       'updated_at', 'delete_after_run', 'next_run_at', 'last_run_at',
@@ -137,7 +138,7 @@ export default function migrateConsolidate() {
       `).get()?.cnt ?? 0)
     : 0;
   if (
-    current >= 23
+    current >= 24
     && hasLatestColumns
     && legacyAtIsoCount === 0
     && legacyPayloadMismatchCount === 0
@@ -345,6 +346,9 @@ export default function migrateConsolidate() {
     `ALTER TABLE runs ADD COLUMN credential_handoff_summary TEXT DEFAULT NULL`,
     // v23: child credential policy
     `ALTER TABLE jobs ADD COLUMN child_credential_policy TEXT DEFAULT NULL`,
+    // v24: explicit fallback model/auth selection
+    `ALTER TABLE jobs ADD COLUMN payload_model_fallback TEXT`,
+    `ALTER TABLE jobs ADD COLUMN auth_profile_fallback TEXT DEFAULT NULL`,
   ];
 
   for (const sql of alters) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-scheduler",
-  "version": "0.2.9",
+  "version": "0.2.10",
   "description": "SQLite-backed job scheduler and workflow engine for OpenClaw agents",
   "type": "module",
   "main": "./index.js",
@@ -17,7 +17,7 @@
     "./package.json": "./package.json"
   },
   "engines": {
-    "node": ">=22"
+    "node": "22.x || 24.x || 26.x"
   },
   "scripts": {
     "start": "node dispatcher.js",
@@ -123,7 +123,7 @@
   },
   "homepage": "https://github.com/amittell/openclaw-scheduler#readme",
   "dependencies": {
-    "better-sqlite3": "^11.10.0",
+    "better-sqlite3": "^12.10.0",
     "croner": "^10.0.1"
   },
   "devDependencies": {

package/paths.js

@@ -1,5 +1,5 @@
 import { accessSync, constants, existsSync, mkdirSync } from 'fs';
-import { homedir } from 'os';
+import { homedir, tmpdir } from 'os';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 
@@ -25,6 +25,17 @@ function isNodeModulesInstall(moduleDir) {
   return /[\\/]node_modules[\\/](?:@[^\\/]+[\\/])?openclaw-scheduler(?:[\\/]|$)/.test(moduleDir);
 }
 
+function isUsableWorkingDirectory(dirPath) {
+  const candidate = firstNonEmpty(dirPath);
+  if (!candidate) return false;
+  try {
+    accessSync(candidate, constants.R_OK | constants.X_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 export function resolveSchedulerHome(env = process.env) {
   const explicitHome = firstNonEmpty(env.SCHEDULER_HOME);
   if (explicitHome) return explicitHome;
@@ -62,6 +73,37 @@ export function resolveBackupStagingDir(env = process.env) {
   return join(resolveSchedulerHome(env), '.backup-staging');
 }
 
+export function resolveServiceWorkingDirectory(params = {}) {
+  const env = params.env || process.env;
+  const explicitPath = firstNonEmpty(params.explicitPath);
+  if (explicitPath) {
+    try {
+      mkdirSync(explicitPath, { recursive: true });
+      if (isUsableWorkingDirectory(explicitPath)) return explicitPath;
+    } catch {
+      // Fall through to install-root/scheduler-home heuristics.
+    }
+  }
+
+  const moduleDir = firstNonEmpty(params.moduleDir) || __dirname;
+  if (!isNodeModulesInstall(moduleDir) && isUsableWorkingDirectory(moduleDir)) {
+    return moduleDir;
+  }
+
+  const schedulerHome = resolveSchedulerHome(env);
+  try {
+    mkdirSync(schedulerHome, { recursive: true });
+    if (isUsableWorkingDirectory(schedulerHome)) return schedulerHome;
+  } catch {
+    // Fall through to other safe directories.
+  }
+
+  const home = firstNonEmpty(env.HOME) || homedir();
+  if (isUsableWorkingDirectory(home)) return home;
+
+  return tmpdir();
+}
+
 export function resolveArtifactsDir(params = {}) {
   const env = params.env || process.env;
   const explicit = firstNonEmpty(params.explicitPath) || firstNonEmpty(env.SCHEDULER_ARTIFACTS_DIR);

package/scheduler-schema.js

@@ -11,6 +11,7 @@ export const SCHEDULER_SCHEMAS = {
       payload_kind: { type: 'string', enum: ['systemEvent', 'agentTurn', 'shellCommand'] },
       payload_message: { type: 'string', maxLength: 100000 },
       payload_model: { type: 'string', nullable: true },
+      payload_model_fallback: { type: 'string', nullable: true, description: 'Optional fallback model override for a same-run retry after primary selection failure' },
       payload_thinking: { type: 'string', nullable: true },
       payload_timeout_seconds: { type: 'integer', min: 1, default: 120 },
       execution_intent: { type: 'string', enum: ['execute', 'plan'], default: 'execute' },
@@ -45,6 +46,7 @@ export const SCHEDULER_SCHEMAS = {
       output_offload_threshold_bytes: { type: 'integer', min: 128, default: 65536 },
       preferred_session_key: { type: 'string', nullable: true },
       auth_profile: { type: 'string', nullable: true, description: 'Auth profile override: null=default, "inherit"=main session profile, or "provider:label"' },
+      auth_profile_fallback: { type: 'string', nullable: true, description: 'Optional fallback auth profile for a same-run retry after primary selection failure' },
       delivery_opt_out_reason: { type: 'string', nullable: true, maxLength: 256 },
       delete_after_run: { type: 'boolean', default: false },
       run_now: { type: 'boolean', default: false, note: 'create-time convenience flag' },

package/schema.sql

@@ -1,4 +1,4 @@
--- OpenClaw Scheduler Schema (current: v1.7.0, schema version: 23)
+-- OpenClaw Scheduler Schema (current: v1.7.0, schema version: 24)
 -- Full standalone scheduler + message router
 
 -- ============================================================
@@ -23,6 +23,7 @@ CREATE TABLE IF NOT EXISTS jobs (
   payload_kind    TEXT NOT NULL,                      -- 'systemEvent' | 'agentTurn' | 'shellCommand'
   payload_message TEXT NOT NULL,
   payload_model   TEXT,
+  payload_model_fallback TEXT,
   payload_thinking TEXT,
   payload_timeout_seconds INTEGER DEFAULT 120,
   execution_intent TEXT NOT NULL DEFAULT 'execute',   -- 'execute' | 'plan'
@@ -91,6 +92,9 @@ CREATE TABLE IF NOT EXISTS jobs (
   -- Auth profile override (v16)
   auth_profile    TEXT DEFAULT NULL,                  -- null=default, 'inherit'=main session profile, or 'provider:label'
 
+  -- Fallback selection overrides (v24)
+  auth_profile_fallback TEXT DEFAULT NULL,            -- optional fallback auth profile used after primary selection failure
+
   -- Delivery opt-out (v19)
   delivery_opt_out_reason TEXT DEFAULT NULL,          -- set when delivery_mode='none' to explicitly skip delivery
 
@@ -478,3 +482,4 @@ INSERT OR IGNORE INTO schema_migrations (version) VALUES (20);
 INSERT OR IGNORE INTO schema_migrations (version) VALUES (21);
 INSERT OR IGNORE INTO schema_migrations (version) VALUES (22);
 INSERT OR IGNORE INTO schema_migrations (version) VALUES (23);
+INSERT OR IGNORE INTO schema_migrations (version) VALUES (24);

package/setup.mjs

@@ -19,7 +19,7 @@ import os from 'os';
 import { execSync } from 'child_process';
 
 import { fileURLToPath } from 'url';
-import { ensureSchedulerDbParent, resolveSchedulerDbPath } from './paths.js';
+import { ensureSchedulerDbParent, resolveSchedulerDbPath, resolveServiceWorkingDirectory } from './paths.js';
 import { createJob } from './jobs.js';
 import { initDb } from './db.js';
 
@@ -152,7 +152,8 @@ print();
 // --- Step 1: Paths ------------------------------------------------------------
 
 print('-- Step 1: Paths ---------------------------------------');
-const schedulerPath = __dirname;
+const schedulerInstallRoot = __dirname;
+const serviceWorkingDirectory = resolveServiceWorkingDirectory({ env: process.env, moduleDir: schedulerInstallRoot });
 const defaultWorkspace = path.join(os.homedir(), '.openclaw', 'workspace');
 const workspacePath = await ask('Workspace path', defaultWorkspace);
 const defaultGateway = 'http://127.0.0.1:18789';
@@ -162,10 +163,11 @@ const schedulerDbPath = resolveSchedulerDbPath({ env: process.env });
 if (schedulerDbPath !== ':memory:') ensureSchedulerDbParent(schedulerDbPath);
 
 print();
-print(`  Scheduler:  ${schedulerPath}`);
-print(`  Workspace:  ${workspacePath}`);
-print(`  Gateway:    ${gatewayUrl}`);
-print(`  Deliver to: ${deliverTo || '(none -- skipping job creation)'}`);
+print(`  Scheduler install root: ${schedulerInstallRoot}`);
+print(`  Service working dir:   ${serviceWorkingDirectory}`);
+print(`  Workspace:             ${workspacePath}`);
+print(`  Gateway:               ${gatewayUrl}`);
+print(`  Deliver to:            ${deliverTo || '(none -- skipping job creation)'}`);
 print();
 
 // --- Preflight: npm install behavior -----------------------------------------
@@ -193,9 +195,9 @@ print();
 
 print('-- Step 2: Database migrations -------------------------');
 try {
-  const { setDbPath } = await import(path.join(schedulerPath, 'db.js'));
+  const { setDbPath } = await import(path.join(schedulerInstallRoot, 'db.js'));
   setDbPath(schedulerDbPath);
-  const migrate = (await import(path.join(schedulerPath, 'migrate-consolidate.js'))).default;
+  const migrate = (await import(path.join(schedulerInstallRoot, 'migrate-consolidate.js'))).default;
   const ran = migrate();
   if (ran) {
     ok(`Migrations applied -> ${schedulerDbPath}`);
@@ -213,9 +215,9 @@ print();
 print('-- Step 3: Agent memory files --------------------------');
 
 const memoryMd = path.join(workspacePath, 'MEMORY.md');
-const memoryEntry = `- **Scheduler Queue Pattern:** Use \`node ${schedulerPath}/cli.js msg send <from> <to> "body"\` for signal-only queue entries.
-  Inbox Consumer (\`${schedulerPath}/scripts/inbox-consumer.mjs\`) drains pending queue messages to Telegram.
-  Stuck Run Detector (\`${schedulerPath}/scripts/stuck-run-detector.mjs\`) alerts on stale \`running\` runs.`;
+const memoryEntry = `- **Scheduler Queue Pattern:** Use \`node ${schedulerInstallRoot}/cli.js msg send <from> <to> "body"\` for signal-only queue entries.
+  Inbox Consumer (\`${schedulerInstallRoot}/scripts/inbox-consumer.mjs\`) drains pending queue messages to Telegram.
+  Stuck Run Detector (\`${schedulerInstallRoot}/scripts/stuck-run-detector.mjs\`) alerts on stale \`running\` runs.`;
 
 const memResult = appendIfMissing(memoryMd, 'Scheduler Queue Pattern', memoryEntry);
 if (memResult === true)       ok('Appended scheduler queue entry -> MEMORY.md');
@@ -228,10 +230,10 @@ const indexSection = `### Scheduler & Dispatch
 
 | File | Covers | Load |
 |------|--------|------|
-| \`${schedulerPath}/\` | Standalone SQLite scheduler. CLI: \`node cli.js\`. launchd service: \`ai.openclaw.scheduler\`. | Any scheduler/cron work |
-| \`${schedulerPath}/cli.js\` | Queue + run operations: \`msg send\`, \`msg inbox\`, \`runs running\`, \`runs stale\`. | Day-to-day scheduler operations |
-| \`${schedulerPath}/scripts/inbox-consumer.mjs\` | Drains queue messages for one agent and delivers to Telegram. | Queue/inbox consumption |
-| \`${schedulerPath}/scripts/stuck-run-detector.mjs\` | Detects stale \`running\` runs and exits non-zero for alerts. | Run health monitoring |`;
+| \`${schedulerInstallRoot}/\` | Standalone SQLite scheduler. CLI: \`node cli.js\`. launchd service: \`ai.openclaw.scheduler\`. | Any scheduler/cron work |
+| \`${schedulerInstallRoot}/cli.js\` | Queue + run operations: \`msg send\`, \`msg inbox\`, \`runs running\`, \`runs stale\`. | Day-to-day scheduler operations |
+| \`${schedulerInstallRoot}/scripts/inbox-consumer.mjs\` | Drains queue messages for one agent and delivers to Telegram. | Queue/inbox consumption |
+| \`${schedulerInstallRoot}/scripts/stuck-run-detector.mjs\` | Detects stale \`running\` runs and exits non-zero for alerts. | Run health monitoring |`;
 
 // Try inserting before a common section header, fall back to append.
 // NOTE: the link emoji anchors must match the actual markdown heading in
@@ -278,7 +280,7 @@ if (!deliverTo) {
     const existingNames = listJobs().map(r => r.name);
 
     // Inbox Consumer
-    const icScript = path.join(schedulerPath, 'scripts', 'inbox-consumer.mjs');
+    const icScript = path.join(schedulerInstallRoot, 'scripts', 'inbox-consumer.mjs');
     const icName = 'Inbox Consumer';
     if (existingNames.includes(icName)) {
       skip(`"${icName}" job already exists`);
@@ -304,7 +306,7 @@ if (!deliverTo) {
 
     // Stuck Run Detector
     const srdName = 'Stuck Run Detector';
-    const srdScript = path.join(schedulerPath, 'scripts', 'stuck-run-detector.mjs');
+    const srdScript = path.join(schedulerInstallRoot, 'scripts', 'stuck-run-detector.mjs');
     const srdCmd = `node ${srdScript} --threshold-min 45`;  // coding tasks regularly take 30m+
     if (existingNames.includes(srdName)) {
       skip(`"${srdName}" job already exists`);
@@ -338,7 +340,7 @@ print();
 
 const platform = process.platform;
 const nodePath  = process.execPath;
-const indexPath = path.join(schedulerPath, 'dispatcher.js');
+const indexPath = path.join(schedulerInstallRoot, 'dispatcher.js');
 const logPath   = platform === 'win32'
   ? path.join(os.tmpdir(), 'openclaw-scheduler.log')
   : '/tmp/openclaw-scheduler.log';
@@ -457,7 +459,7 @@ if (platform === 'darwin') {
     <string>${xmlEscape(indexPath)}</string>
   </array>
 ${userXml}  <key>WorkingDirectory</key>
-  <string>${xmlEscape(schedulerPath)}</string>
+  <string>${xmlEscape(serviceWorkingDirectory)}</string>
   <key>EnvironmentVariables</key>
   <dict>
     <key>HOME</key>
@@ -565,7 +567,7 @@ After=network.target
 
 [Service]
 Type=simple
-WorkingDirectory=${schedulerPath}
+WorkingDirectory=${serviceWorkingDirectory}
 ExecStart=${nodePath} --no-warnings ${indexPath}
 Environment=OPENCLAW_GATEWAY_URL=${gatewayUrl}${gatewayToken ? `\nEnvironment="OPENCLAW_GATEWAY_TOKEN=${gatewayToken.replace(/"/g, '\\"')}"` : ''}
 Environment=SCHEDULER_DB=${schedulerDbPath}
@@ -612,7 +614,7 @@ WantedBy=default.target
       if (install) {
         try {
           execSync(
-            `pm2 start "${indexPath}" --name "${pm2Name}" --cwd "${schedulerPath}" ` +
+            `pm2 start "${indexPath}" --name "${pm2Name}" --cwd "${serviceWorkingDirectory}" ` +
             `--log "${logPath}"`,
             {
               stdio: 'inherit',
@@ -652,7 +654,7 @@ WantedBy=default.target
   print('  Setup steps:');
   print('  1. Install WSL2:  wsl --install  (in PowerShell as Admin)');
   print('  2. Open your WSL terminal and run this wizard again from there:');
-  print(`     cd ${schedulerPath.replace(/\\/g, '/')}`);
+  print(`     cd ${schedulerInstallRoot.replace(/\\/g, '/')}`);
   print('     node setup.mjs');
   print();
   print('  WSL2 with systemd enabled gives the best experience (auto-start on login).');