@nextclaw/server 0.5.4 → 0.5.6

package/dist/index.d.ts

@@ -1,5 +1,6 @@
+import * as NextclawCore from '@nextclaw/core';
+import { CronService, Config, ConfigActionExecuteRequest as ConfigActionExecuteRequest$1, ConfigActionExecuteResult as ConfigActionExecuteResult$1 } from '@nextclaw/core';
 import { Hono } from 'hono';
-import { Config, ConfigActionExecuteRequest as ConfigActionExecuteRequest$1, ConfigActionExecuteResult as ConfigActionExecuteResult$1 } from '@nextclaw/core';
 
 type ApiError = {
     code: string;
@@ -85,6 +86,55 @@ type SessionPatchUpdate = {
     preferredModel?: string | null;
     clearHistory?: boolean;
 };
+type CronScheduleView = {
+    kind: "at";
+    atMs?: number | null;
+} | {
+    kind: "every";
+    everyMs?: number | null;
+} | {
+    kind: "cron";
+    expr?: string | null;
+    tz?: string | null;
+};
+type CronPayloadView = {
+    kind?: "system_event" | "agent_turn";
+    message: string;
+    deliver?: boolean;
+    channel?: string | null;
+    to?: string | null;
+};
+type CronJobStateView = {
+    nextRunAt?: string | null;
+    lastRunAt?: string | null;
+    lastStatus?: "ok" | "error" | "skipped" | null;
+    lastError?: string | null;
+};
+type CronJobView = {
+    id: string;
+    name: string;
+    enabled: boolean;
+    schedule: CronScheduleView;
+    payload: CronPayloadView;
+    state: CronJobStateView;
+    createdAt: string;
+    updatedAt: string;
+    deleteAfterRun: boolean;
+};
+type CronListView = {
+    jobs: CronJobView[];
+    total: number;
+};
+type CronEnableRequest = {
+    enabled: boolean;
+};
+type CronRunRequest = {
+    force?: boolean;
+};
+type CronActionResult = {
+    job: CronJobView | null;
+    executed?: boolean;
+};
 type RuntimeConfigUpdate = {
     agents?: {
         defaults?: {
@@ -363,6 +413,7 @@ type UiServerOptions = {
     corsOrigins?: string[] | "*";
     staticDir?: string;
     marketplace?: MarketplaceApiConfig;
+    cronService?: CronService;
 };
 type UiServerHandle = {
     host: string;
@@ -377,6 +428,7 @@ type UiRouterOptions = {
     configPath: string;
     publish: (event: UiServerEvent) => void;
     marketplace?: MarketplaceApiConfig;
+    cronService?: InstanceType<typeof NextclawCore.CronService>;
 };
 declare function createUiRouter(options: UiRouterOptions): Hono;
 
@@ -410,4 +462,4 @@ declare function patchSession(configPath: string, key: string, patch: SessionPat
 declare function deleteSession(configPath: string, key: string): boolean;
 declare function updateRuntime(configPath: string, patch: RuntimeConfigUpdate): Pick<ConfigView, "agents" | "bindings" | "session">;
 
-export { type AgentBindingView, type AgentProfileView, type ApiError, type ApiResponse, type BindingPeerView, type ChannelSpecView, type ConfigActionExecuteRequest, type ConfigActionExecuteResult, type ConfigActionManifest, type ConfigActionType, type ConfigMetaView, type ConfigSchemaResponse, type ConfigUiHint, type ConfigUiHints, type ConfigView, type MarketplaceApiConfig, type MarketplaceInstallKind, type MarketplaceInstallRequest, type MarketplaceInstallResult, type MarketplaceInstallSkillParams, type MarketplaceInstallSpec, type MarketplaceInstalledRecord, type MarketplaceInstalledView, type MarketplaceInstaller, type MarketplaceItemSummary, type MarketplaceItemType, type MarketplaceItemView, type MarketplaceListView, type MarketplaceManageAction, type MarketplaceManageRequest, type MarketplaceManageResult, type MarketplaceRecommendationView, type MarketplaceSort, type ProviderConfigUpdate, type ProviderConfigView, type ProviderSpecView, type RuntimeConfigUpdate, type SessionConfigView, type SessionEntryView, type SessionHistoryView, type SessionMessageView, type SessionPatchUpdate, type SessionsListView, type UiServerEvent, type UiServerHandle, type UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createUiRouter, deleteSession, executeConfigAction, getSessionHistory, listSessions, loadConfigOrDefault, patchSession, startUiServer, updateChannel, updateModel, updateProvider, updateRuntime };
+export { type AgentBindingView, type AgentProfileView, type ApiError, type ApiResponse, type BindingPeerView, type ChannelSpecView, type ConfigActionExecuteRequest, type ConfigActionExecuteResult, type ConfigActionManifest, type ConfigActionType, type ConfigMetaView, type ConfigSchemaResponse, type ConfigUiHint, type ConfigUiHints, type ConfigView, type CronActionResult, type CronEnableRequest, type CronJobStateView, type CronJobView, type CronListView, type CronPayloadView, type CronRunRequest, type CronScheduleView, type MarketplaceApiConfig, type MarketplaceInstallKind, type MarketplaceInstallRequest, type MarketplaceInstallResult, type MarketplaceInstallSkillParams, type MarketplaceInstallSpec, type MarketplaceInstalledRecord, type MarketplaceInstalledView, type MarketplaceInstaller, type MarketplaceItemSummary, type MarketplaceItemType, type MarketplaceItemView, type MarketplaceListView, type MarketplaceManageAction, type MarketplaceManageRequest, type MarketplaceManageResult, type MarketplaceRecommendationView, type MarketplaceSort, type ProviderConfigUpdate, type ProviderConfigView, type ProviderSpecView, type RuntimeConfigUpdate, type SessionConfigView, type SessionEntryView, type SessionHistoryView, type SessionMessageView, type SessionPatchUpdate, type SessionsListView, type UiServerEvent, type UiServerHandle, type UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createUiRouter, deleteSession, executeConfigAction, getSessionHistory, listSessions, loadConfigOrDefault, patchSession, startUiServer, updateChannel, updateModel, updateProvider, updateRuntime };

package/dist/index.js

@@ -691,6 +691,38 @@ function ok(data) {
 function err(code, message, details) {
   return { ok: false, error: { code, message, details } };
 }
+function toIsoTime(value) {
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    return null;
+  }
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) {
+    return null;
+  }
+  return date.toISOString();
+}
+function buildCronJobView(job) {
+  return {
+    id: job.id,
+    name: job.name,
+    enabled: job.enabled,
+    schedule: job.schedule,
+    payload: job.payload,
+    state: {
+      nextRunAt: toIsoTime(job.state.nextRunAtMs),
+      lastRunAt: toIsoTime(job.state.lastRunAtMs),
+      lastStatus: job.state.lastStatus ?? null,
+      lastError: job.state.lastError ?? null
+    },
+    createdAt: new Date(job.createdAtMs).toISOString(),
+    updatedAt: new Date(job.updatedAtMs).toISOString(),
+    deleteAfterRun: job.deleteAfterRun
+  };
+}
+function findCronJob(service, id) {
+  const jobs = service.listJobs(true);
+  return jobs.find((job) => job.id === id) ?? null;
+}
 async function readJson(req) {
   try {
     const data = await req.json();
@@ -1306,6 +1338,66 @@ function createUiRouter(options) {
     options.publish({ type: "config.updated", payload: { path: "session" } });
     return c.json(ok({ deleted: true }));
   });
+  app.get("/api/cron", (c) => {
+    if (!options.cronService) {
+      return c.json(err("NOT_AVAILABLE", "cron service unavailable"), 503);
+    }
+    const query = c.req.query();
+    const includeDisabled = query.all === "1" || query.all === "true" || query.all === "yes";
+    const jobs = options.cronService.listJobs(includeDisabled).map((job) => buildCronJobView(job));
+    return c.json(ok({ jobs, total: jobs.length }));
+  });
+  app.delete("/api/cron/:id", (c) => {
+    if (!options.cronService) {
+      return c.json(err("NOT_AVAILABLE", "cron service unavailable"), 503);
+    }
+    const id = decodeURIComponent(c.req.param("id"));
+    const deleted = options.cronService.removeJob(id);
+    if (!deleted) {
+      return c.json(err("NOT_FOUND", `cron job not found: ${id}`), 404);
+    }
+    return c.json(ok({ deleted: true }));
+  });
+  app.put("/api/cron/:id/enable", async (c) => {
+    if (!options.cronService) {
+      return c.json(err("NOT_AVAILABLE", "cron service unavailable"), 503);
+    }
+    const id = decodeURIComponent(c.req.param("id"));
+    const body = await readJson(c.req.raw);
+    if (!body.ok) {
+      return c.json(err("INVALID_BODY", "invalid json body"), 400);
+    }
+    if (typeof body.data.enabled !== "boolean") {
+      return c.json(err("INVALID_BODY", "enabled must be boolean"), 400);
+    }
+    const job = options.cronService.enableJob(id, body.data.enabled);
+    if (!job) {
+      return c.json(err("NOT_FOUND", `cron job not found: ${id}`), 404);
+    }
+    const data = { job: buildCronJobView(job) };
+    return c.json(ok(data));
+  });
+  app.post("/api/cron/:id/run", async (c) => {
+    if (!options.cronService) {
+      return c.json(err("NOT_AVAILABLE", "cron service unavailable"), 503);
+    }
+    const id = decodeURIComponent(c.req.param("id"));
+    const body = await readJson(c.req.raw);
+    if (!body.ok) {
+      return c.json(err("INVALID_BODY", "invalid json body"), 400);
+    }
+    const existing = findCronJob(options.cronService, id);
+    if (!existing) {
+      return c.json(err("NOT_FOUND", `cron job not found: ${id}`), 404);
+    }
+    const executed = await options.cronService.runJob(id, Boolean(body.data.force));
+    const after = findCronJob(options.cronService, id);
+    const data = {
+      job: after ? buildCronJobView(after) : null,
+      executed
+    };
+    return c.json(ok(data));
+  });
   app.put("/api/config/runtime", async (c) => {
     const body = await readJson(c.req.raw);
     if (!body.ok || !body.data || typeof body.data !== "object") {
@@ -1365,7 +1457,8 @@ function startUiServer(options) {
     createUiRouter({
       configPath: options.configPath,
       publish,
-      marketplace: options.marketplace
+      marketplace: options.marketplace,
+      cronService: options.cronService
     })
   );
   const staticDir = options.staticDir;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/server",
-  "version": "0.5.4",
+  "version": "0.5.6",
   "private": false,
   "description": "Nextclaw UI/API server.",
   "type": "module",
@@ -15,10 +15,10 @@
   ],
   "dependencies": {
     "@hono/node-server": "^1.13.3",
-    "@nextclaw/openclaw-compat": "^0.1.21",
+    "@nextclaw/openclaw-compat": "^0.1.23",
     "hono": "^4.6.2",
     "ws": "^8.18.0",
-    "@nextclaw/core": "^0.6.28"
+    "@nextclaw/core": "^0.6.30"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",