@omnixal/openclaw-nats-plugin 0.2.0 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omnixal/openclaw-nats-plugin",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "NATS JetStream event-driven plugin for OpenClaw",
   "license": "MIT",
   "type": "module",
@@ -10,7 +10,8 @@
   },
   "scripts": {
     "build:dashboard": "cd dashboard && bun run build",
-    "prepublishOnly": "bun run build:dashboard"
+    "prepublishOnly": "bun run build:dashboard",
+    "nats": "docker run -d --name nats -p 4222:4222 nats:2.10-alpine -js"
   },
   "files": [
     "index.ts",

package/plugins/nats-context-engine/http-handler.ts

@@ -55,7 +55,7 @@ async function proxyToSidecar(
     }
 
     let body: string | undefined;
-    if (req.method === 'POST' || req.method === 'PUT') {
+    if (req.method === 'POST' || req.method === 'PUT' || req.method === 'PATCH') {
       body = await readBody(req);
     }
 

package/plugins/nats-context-engine/index.ts

@@ -172,6 +172,65 @@ export default function (api: any) {
     },
   });
 
+  // ── Cron Scheduler Tools ────────────────────────────────────────────
+
+  api.registerTool({
+    name: 'nats_cron_add',
+    description: 'Create or update a scheduled cron job that publishes a NATS event on a schedule. No LLM wake — fires directly.',
+    parameters: {
+      type: 'object',
+      properties: {
+        name: { type: 'string', description: 'Unique job name (e.g., daily-report, hourly-check)' },
+        cron: { type: 'string', description: 'Cron expression (e.g., "0 9 * * *" for daily at 9am)' },
+        subject: { type: 'string', description: 'NATS subject to publish (must start with agent.events.)' },
+        payload: { type: 'object', description: 'Event payload data' },
+        timezone: { type: 'string', description: 'Timezone (default: UTC). e.g., Europe/Moscow' },
+      },
+      required: ['name', 'cron', 'subject'],
+    },
+    async execute(_id: string, params: any) {
+      const result = await sidecarFetch('/api/cron', {
+        method: 'POST',
+        body: JSON.stringify({
+          name: params.name,
+          cron: params.cron,
+          subject: params.subject,
+          payload: params.payload ?? {},
+          timezone: params.timezone,
+        }),
+      });
+      return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    },
+  });
+
+  api.registerTool({
+    name: 'nats_cron_remove',
+    description: 'Remove a scheduled cron job by name.',
+    parameters: {
+      type: 'object',
+      properties: {
+        name: { type: 'string', description: 'Job name to remove' },
+      },
+      required: ['name'],
+    },
+    async execute(_id: string, params: any) {
+      const result = await sidecarFetch(`/api/cron/${encodeURIComponent(params.name)}`, {
+        method: 'DELETE',
+      });
+      return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    },
+  });
+
+  api.registerTool({
+    name: 'nats_cron_list',
+    description: 'List all scheduled cron jobs with their next run time and status.',
+    parameters: { type: 'object', properties: {} },
+    async execute() {
+      const result = await sidecarFetch('/api/cron');
+      return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    },
+  });
+
   // ── Dashboard UI ─────────────────────────────────────────────────
 
   api.registerHttpRoute({

package/sidecar/bun.lock

@@ -5,11 +5,11 @@
     "": {
       "name": "@ai-entrepreneur/nats-sidecar",
       "dependencies": {
-        "@onebun/core": "^0.2.12",
+        "@onebun/core": "^0.2.14",
         "@onebun/drizzle": "^0.2.4",
-        "@onebun/envs": "^0.2.1",
+        "@onebun/envs": "^0.2.2",
         "@onebun/logger": "^0.2.1",
-        "@onebun/nats": "^0.2.5",
+        "@onebun/nats": "^0.2.6",
         "arktype": "^2.2.0",
         "ulid": "^2.3.0",
       },
@@ -104,17 +104,17 @@
 
     "@nats-io/transport-node": ["@nats-io/transport-node@3.3.1", "", { "dependencies": { "@nats-io/nats-core": "3.3.1", "@nats-io/nkeys": "2.0.3", "@nats-io/nuid": "2.0.3" } }, "sha512-GBvY0VcvyQEILgy5bjpqU1GpDYmSF06bW59I7cewZuNGS9u3AoV/gf+a+3ep45T/Z+UC661atq/b7x+QV12w+Q=="],
 
-    "@onebun/core": ["@onebun/core@0.2.12", "", { "dependencies": { "@onebun/envs": "^0.2.1", "@onebun/logger": "^0.2.1", "@onebun/metrics": "^0.2.2", "@onebun/requests": "^0.2.1", "@onebun/trace": "^0.2.1", "arktype": "^2.0.0", "effect": "^3.13.10" }, "peerDependencies": { "testcontainers": ">=10.0.0" }, "optionalPeers": ["testcontainers"] }, "sha512-Vy3A0pmp/eZjwgEgdZApMKHPJ697LvQETmqEWyUqUr01zcfy0HYI9KcRBRIHlGoajAYghwH+D9w4N3Ip6pGCcA=="],
+    "@onebun/core": ["@onebun/core@0.2.14", "", { "dependencies": { "@onebun/envs": "^0.2.2", "@onebun/logger": "^0.2.1", "@onebun/metrics": "^0.2.2", "@onebun/requests": "^0.2.1", "@onebun/trace": "^0.2.1", "arktype": "^2.0.0", "effect": "^3.13.10" }, "peerDependencies": { "testcontainers": ">=10.0.0" }, "optionalPeers": ["testcontainers"] }, "sha512-uClu4Oez18y6BldubdE6R/I02Brrk5eXCoxxPatgRJ9qYRM+jKSTNmeZVoqqo7ai/rMYM9lJ1WuF9d7p6/RtDA=="],
 
     "@onebun/drizzle": ["@onebun/drizzle@0.2.4", "", { "dependencies": { "@onebun/envs": "^0.2.1", "@onebun/logger": "^0.2.1", "arktype": "^2.0.0", "drizzle-arktype": "^0.1.3", "drizzle-kit": "^0.31.6", "drizzle-orm": "^0.44.7", "effect": "^3.13.10" }, "peerDependencies": { "@onebun/core": ">=0.2.0" }, "bin": { "onebun-drizzle": "bin/drizzle-kit.ts" } }, "sha512-LbkW2hU9pTKZU/rlrHNdwhI4jYoMl+v22c3G2zc0L0aW77nW7ZCfp5YqOJYufWJbfOTSWEnNOVZQXMueYhBxsA=="],
 
-    "@onebun/envs": ["@onebun/envs@0.2.1", "", { "dependencies": { "effect": "^3.13.10" } }, "sha512-kiXJcA4ct194+aNJK8zkrVuaAgPPVpTkcW8tJU9XN9KOh8003lENOOuUZUcieMCxdMWUgo08lp9UgiwawLan+Q=="],
+    "@onebun/envs": ["@onebun/envs@0.2.2", "", { "dependencies": { "effect": "^3.13.10" } }, "sha512-WIjc1LpGnecYArSWsZhheyUSYJlo+iz9SA7ZfIXQnt1vkLd7ILCmVCtODBvqG9Mh86CMmromf1lCyRkjNZyLoA=="],
 
     "@onebun/logger": ["@onebun/logger@0.2.1", "", { "dependencies": { "effect": "^3.13.10" } }, "sha512-u/zirsUSGBfbjVv274qqIHG5jzPBWY3vl8HzM6hjzsMCCpExgstkQiP1eP9rF1isIzhetwmyfBpYYc9eYsbrrw=="],
 
     "@onebun/metrics": ["@onebun/metrics@0.2.2", "", { "dependencies": { "@onebun/requests": "^0.2.1", "effect": "^3.13.10", "prom-client": "^15.1.3" } }, "sha512-8oN74MZeaWyyPHi5H3pZyY0V3cM8ORupHe2fR0gGYsZqHyM4S9UJStV29rNQlvhyesHzL7p5x3Ux6n/SRYBszw=="],
 
-    "@onebun/nats": ["@onebun/nats@0.2.5", "", { "dependencies": { "@nats-io/jetstream": "^3.0.0-31", "@nats-io/transport-node": "^3.0.0-31", "effect": "^3.13.10" }, "peerDependencies": { "@onebun/core": ">=0.2.0" } }, "sha512-J+p9UPJGqBLeeBY6n50E6at1lyA+xmg+wzqw1HwN516t+XHzctmnrB8S5PmX/3sQI18fktFcJgAyWJfQA1piDA=="],
+    "@onebun/nats": ["@onebun/nats@0.2.6", "", { "dependencies": { "@nats-io/jetstream": "^3.0.0-31", "@nats-io/transport-node": "^3.0.0-31", "effect": "^3.13.10" }, "peerDependencies": { "@onebun/core": ">=0.2.0" } }, "sha512-b7b0PUu0eGDLPbstOVjaCW0GCKsBzQb8qyYQmjKPu6RCsm02qvUU8HWDytoy01mYnQxWpI93qVogGiQKd6Ps4A=="],
 
     "@onebun/requests": ["@onebun/requests@0.2.1", "", { "dependencies": { "effect": "^3.13.10" } }, "sha512-Wit+o3zRiuZOM7O0nAJ0rpFVLgkypJ1UR5uuHi0IZuiCvGmxv+Vus2+QqHoCL141L7SPO1Xlywt8dVqqu4NP7w=="],
 
@@ -446,6 +446,8 @@
 
     "@isaacs/cliui/wrap-ansi": ["wrap-ansi@8.1.0", "", { "dependencies": { "ansi-styles": "^6.1.0", "string-width": "^5.0.1", "strip-ansi": "^7.0.1" } }, "sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ=="],
 
+    "@onebun/drizzle/@onebun/envs": ["@onebun/envs@0.2.1", "", { "dependencies": { "effect": "^3.13.10" } }, "sha512-kiXJcA4ct194+aNJK8zkrVuaAgPPVpTkcW8tJU9XN9KOh8003lENOOuUZUcieMCxdMWUgo08lp9UgiwawLan+Q=="],
+
     "bcrypt-pbkdf/tweetnacl": ["tweetnacl@0.14.5", "", {}, "sha512-KXXFFdAbFXY4geFIwoyNK+f5Z1b7swfXABfL7HXCmoIWMKU3dmS26672A4EeQtDzLKy7SXmfBu51JolvEKwtGA=="],
 
     "bl/buffer": ["buffer@5.7.1", "", { "dependencies": { "base64-js": "^1.3.1", "ieee754": "^1.1.13" } }, "sha512-EHcyIPBQ4BSGlvjB16k5KgAJ27CIsHY/2JBmCRReo48y9rQ3MaUzWX3KVlBa4U7MyX02HdVj0K7C3WaB3ju7FQ=="],

package/sidecar/package.json

@@ -11,14 +11,14 @@
     "typecheck": "bunx tsc --noEmit",
     "db:generate": "bunx onebun-drizzle generate",
     "db:push": "bunx onebun-drizzle push",
-    "db:studio": "bunx onebun-drizzle studio"
+    "db:studio": "bunx onebun-drizzle studio",
   },
   "dependencies": {
-    "@onebun/core": "^0.2.12",
+    "@onebun/core": "^0.2.14",
     "@onebun/drizzle": "^0.2.4",
-    "@onebun/envs": "^0.2.1",
+    "@onebun/envs": "^0.2.2",
     "@onebun/logger": "^0.2.1",
-    "@onebun/nats": "^0.2.5",
+    "@onebun/nats": "^0.2.6",
     "arktype": "^2.2.0",
     "ulid": "^2.3.0"
   },

package/sidecar/src/app.module.ts

@@ -1,5 +1,6 @@
-import { Module } from '@onebun/core';
+import { getConfig, Module } from '@onebun/core';
 import { DrizzleModule, DatabaseType } from '@onebun/drizzle';
+import { envSchema, type AppConfig } from './config';
 import { DedupModule } from './dedup/dedup.module';
 import { PublisherModule } from './publisher/publisher.module';
 import { PreHandlersModule } from './pre-handlers/pre-handlers.module';
@@ -8,6 +9,10 @@ import { ConsumerModule } from './consumer/consumer.module';
 import { PendingModule } from './pending/pending.module';
 import { HealthModule } from './health/health.module';
 import { RouterModule } from './router/router.module';
+import { SchedulerModule } from './scheduler/scheduler.module';
+import { MetricsModule } from './metrics/metrics.module';
+
+const config = getConfig<AppConfig>(envSchema);
 
 @Module({
   imports: [
@@ -15,7 +20,7 @@ import { RouterModule } from './router/router.module';
       connection: {
         type: DatabaseType.SQLITE,
         options: {
-          url: process.env.DB_PATH ?? './data/nats-sidecar.db',
+          url: config.get('database.url'),
         },
       },
       migrationsFolder: './src/db/migrations',
@@ -28,6 +33,8 @@ import { RouterModule } from './router/router.module';
     PendingModule,
     HealthModule,
     RouterModule,
+    SchedulerModule,
+    MetricsModule,
   ],
 })
 export class AppModule {}

package/sidecar/src/consumer/consumer.controller.ts

@@ -3,6 +3,7 @@ import { PipelineService } from '../pre-handlers/pipeline.service';
 import { GatewayClientService } from '../gateway/gateway-client.service';
 import { PendingService } from '../pending/pending.service';
 import { RouterService } from '../router/router.service';
+import { MetricsService } from '../metrics/metrics.service';
 import type { NatsEventEnvelope } from '../publisher/envelope';
 
 @Controller('/consumer')
@@ -12,6 +13,7 @@ export class ConsumerController extends BaseController {
     private gatewayClient: GatewayClientService,
     private pendingService: PendingService,
     private routerService: RouterService,
+    private metrics: MetricsService,
   ) {
     super();
   }
@@ -57,6 +59,8 @@ export class ConsumerController extends BaseController {
               priority: (ctx.enrichments['priority'] as number) ?? envelope.meta?.priority ?? 5,
             },
           });
+          await this.routerService.recordDelivery(route.id, envelope.subject);
+          this.metrics.recordConsume(envelope.subject);
         }
         await message.ack();
       } else {

package/sidecar/src/consumer/consumer.module.ts

@@ -3,9 +3,10 @@ import { ConsumerController } from './consumer.controller';
 import { PreHandlersModule } from '../pre-handlers/pre-handlers.module';
 import { PendingModule } from '../pending/pending.module';
 import { RouterModule } from '../router/router.module';
+import { MetricsModule } from '../metrics/metrics.module';
 
 @Module({
-  imports: [PreHandlersModule, PendingModule, RouterModule],
+  imports: [PreHandlersModule, PendingModule, RouterModule, MetricsModule],
   controllers: [ConsumerController],
 })
 export class ConsumerModule {}

package/sidecar/src/db/migrations/0004_familiar_zaladane.sql

@@ -0,0 +1,17 @@
+CREATE TABLE `cron_jobs` (
+	`id` text PRIMARY KEY NOT NULL,
+	`name` text NOT NULL,
+	`expr` text NOT NULL,
+	`subject` text NOT NULL,
+	`payload` text,
+	`timezone` text DEFAULT 'UTC' NOT NULL,
+	`enabled` integer DEFAULT true NOT NULL,
+	`last_run_at` integer,
+	`created_at` integer NOT NULL
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `cron_jobs_name_unique` ON `cron_jobs` (`name`);--> statement-breakpoint
+CREATE INDEX `cron_jobs_name_idx` ON `cron_jobs` (`name`);--> statement-breakpoint
+ALTER TABLE `event_routes` ADD `last_delivered_at` integer;--> statement-breakpoint
+ALTER TABLE `event_routes` ADD `last_event_subject` text;--> statement-breakpoint
+ALTER TABLE `event_routes` ADD `delivery_count` integer DEFAULT 0 NOT NULL;

package/sidecar/src/db/migrations/meta/0004_snapshot.json

@@ -0,0 +1,306 @@
+{
+  "version": "6",
+  "dialect": "sqlite",
+  "id": "e31f4610-cdfc-459e-b947-8363975599a0",
+  "prevId": "cb92737c-c257-4b58-bbf0-798ab1494961",
+  "tables": {
+    "cron_jobs": {
+      "name": "cron_jobs",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "name": {
+          "name": "name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "expr": {
+          "name": "expr",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "subject": {
+          "name": "subject",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "payload": {
+          "name": "payload",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "timezone": {
+          "name": "timezone",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'UTC'"
+        },
+        "enabled": {
+          "name": "enabled",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": true
+        },
+        "last_run_at": {
+          "name": "last_run_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        }
+      },
+      "indexes": {
+        "cron_jobs_name_unique": {
+          "name": "cron_jobs_name_unique",
+          "columns": [
+            "name"
+          ],
+          "isUnique": true
+        },
+        "cron_jobs_name_idx": {
+          "name": "cron_jobs_name_idx",
+          "columns": [
+            "name"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "dedup_events": {
+      "name": "dedup_events",
+      "columns": {
+        "event_id": {
+          "name": "event_id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "subject": {
+          "name": "subject",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "seen_at": {
+          "name": "seen_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        }
+      },
+      "indexes": {
+        "dedup_events_seen_at_idx": {
+          "name": "dedup_events_seen_at_idx",
+          "columns": [
+            "seen_at"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "event_routes": {
+      "name": "event_routes",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "pattern": {
+          "name": "pattern",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "target": {
+          "name": "target",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'main'"
+        },
+        "enabled": {
+          "name": "enabled",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": true
+        },
+        "priority": {
+          "name": "priority",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 5
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "last_delivered_at": {
+          "name": "last_delivered_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "last_event_subject": {
+          "name": "last_event_subject",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "delivery_count": {
+          "name": "delivery_count",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        }
+      },
+      "indexes": {
+        "event_routes_pattern_unique": {
+          "name": "event_routes_pattern_unique",
+          "columns": [
+            "pattern"
+          ],
+          "isUnique": true
+        },
+        "event_routes_pattern_idx": {
+          "name": "event_routes_pattern_idx",
+          "columns": [
+            "pattern"
+          ],
+          "isUnique": false
+        },
+        "event_routes_target_idx": {
+          "name": "event_routes_target_idx",
+          "columns": [
+            "target"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "pending_events": {
+      "name": "pending_events",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "session_key": {
+          "name": "session_key",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "subject": {
+          "name": "subject",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "payload": {
+          "name": "payload",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "priority": {
+          "name": "priority",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 5
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "delivered_at": {
+          "name": "delivered_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    }
+  },
+  "views": {},
+  "enums": {},
+  "_meta": {
+    "schemas": {},
+    "tables": {},
+    "columns": {}
+  },
+  "internal": {
+    "indexes": {}
+  }
+}

package/sidecar/src/db/migrations/meta/_journal.json

@@ -29,6 +29,13 @@
       "when": 1773938595817,
       "tag": "0003_wet_deathbird",
       "breakpoints": true
+    },
+    {
+      "idx": 4,
+      "version": "6",
+      "when": 1773965190659,
+      "tag": "0004_familiar_zaladane",
+      "breakpoints": true
     }
   ]
 }

package/sidecar/src/db/schema.ts

@@ -28,6 +28,9 @@ export const eventRoutes = sqliteTable('event_routes', {
   enabled:   integer('enabled', { mode: 'boolean' }).notNull().default(true),
   priority:  integer('priority').notNull().default(5),
   createdAt: integer('created_at', { mode: 'timestamp_ms' }).notNull(),
+  lastDeliveredAt: integer('last_delivered_at', { mode: 'timestamp_ms' }),
+  lastEventSubject: text('last_event_subject'),
+  deliveryCount: integer('delivery_count').notNull().default(0),
 }, (table) => [
   index('event_routes_pattern_idx').on(table.pattern),
   index('event_routes_target_idx').on(table.target),
@@ -35,3 +38,20 @@ export const eventRoutes = sqliteTable('event_routes', {
 
 export type DbEventRoute = typeof eventRoutes.$inferSelect;
 export type NewEventRoute = typeof eventRoutes.$inferInsert;
+
+export const cronJobs = sqliteTable('cron_jobs', {
+  id:        text('id').primaryKey(),
+  name:      text('name').notNull().unique(),
+  expr:      text('expr').notNull(),
+  subject:   text('subject').notNull(),
+  payload:   text('payload', { mode: 'json' }).$type<unknown>(),
+  timezone:  text('timezone').notNull().default('UTC'),
+  enabled:   integer('enabled', { mode: 'boolean' }).notNull().default(true),
+  lastRunAt: integer('last_run_at', { mode: 'timestamp_ms' }),
+  createdAt: integer('created_at', { mode: 'timestamp_ms' }).notNull(),
+}, (table) => [
+  index('cron_jobs_name_idx').on(table.name),
+]);
+
+export type DbCronJob = typeof cronJobs.$inferSelect;
+export type NewCronJob = typeof cronJobs.$inferInsert;

package/sidecar/src/health/health.service.ts

@@ -49,7 +49,7 @@ export class HealthService extends BaseService {
       pendingCount,
       uptimeSeconds: Math.floor((Date.now() - this.startedAt) / 1000),
       config: {
-        streams: ['agent_events', 'agent_dlq'],
+        streams: ['agent_events', 'agent_dlq', 'scheduler_internal'],
         consumerName: this.config.get('consumer.name'),
         dedupTtlSeconds: this.config.get('dedup.ttlSeconds'),
       },

package/sidecar/src/index.ts

@@ -35,6 +35,12 @@ const app = new OneBunApplication(AppModule, {
           retention: 'limits',
           maxAge: SEVEN_DAYS_NS,
         },
+        {
+          name: 'scheduler_internal',
+          subjects: ['scheduler.>'],
+          retention: 'limits',
+          maxAge: 24 * 60 * 60 * 1e9, // 1 day
+        },
       ],
       consumerConfig: {
         ackWait: ackWaitMs * 1_000_000, // ms → ns

package/sidecar/src/metrics/metrics.controller.ts

@@ -0,0 +1,16 @@
+import { Controller, BaseController, Get, UseMiddleware } from '@onebun/core';
+import { ApiKeyMiddleware } from '../auth/api-key.middleware';
+import { MetricsService } from './metrics.service';
+
+@Controller('/api/metrics')
+@UseMiddleware(ApiKeyMiddleware)
+export class MetricsController extends BaseController {
+  constructor(private metrics: MetricsService) {
+    super();
+  }
+
+  @Get('/')
+  getAll() {
+    return this.success(this.metrics.getAll());
+  }
+}

package/sidecar/src/metrics/metrics.module.ts

@@ -0,0 +1,10 @@
+import { Module } from '@onebun/core';
+import { MetricsService } from './metrics.service';
+import { MetricsController } from './metrics.controller';
+
+@Module({
+  controllers: [MetricsController],
+  providers: [MetricsService],
+  exports: [MetricsService],
+})
+export class MetricsModule {}