@nextclaw/server 0.5.3 → 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();
@@ -899,12 +931,13 @@ function collectMarketplaceInstalledView(options) {
     records
   };
 }
-function resolvePluginManageTargetId(options, rawTargetId) {
+function resolvePluginManageTargetId(options, rawTargetId, rawSpec) {
   const targetId = rawTargetId.trim();
-  if (!targetId) {
+  if (!targetId && !rawSpec) {
     return rawTargetId;
   }
-  const normalizedTarget = normalizePluginNpmSpec(targetId).toLowerCase();
+  const normalizedTarget = targetId ? normalizePluginNpmSpec(targetId).toLowerCase() : "";
+  const normalizedSpec = rawSpec ? normalizePluginNpmSpec(rawSpec).toLowerCase() : "";
   const installed = collectMarketplaceInstalledView(options);
   const pluginRecords = installed.records.filter((record) => record.type === "plugin");
   const lowerTargetId = targetId.toLowerCase();
@@ -914,13 +947,23 @@ function resolvePluginManageTargetId(options, rawTargetId) {
       return recordId;
     }
   }
-  for (const record of pluginRecords) {
-    const normalizedSpec = normalizePluginNpmSpec(record.spec).toLowerCase();
-    if (normalizedSpec === normalizedTarget && record.id && record.id.trim().length > 0) {
-      return record.id;
+  if (normalizedTarget) {
+    for (const record of pluginRecords) {
+      const normalizedRecordSpec = normalizePluginNpmSpec(record.spec).toLowerCase();
+      if (normalizedRecordSpec === normalizedTarget && record.id && record.id.trim().length > 0) {
+        return record.id;
+      }
     }
   }
-  return targetId;
+  if (normalizedSpec && normalizedSpec !== normalizedTarget) {
+    for (const record of pluginRecords) {
+      const normalizedRecordSpec = normalizePluginNpmSpec(record.spec).toLowerCase();
+      if (normalizedRecordSpec === normalizedSpec && record.id && record.id.trim().length > 0) {
+        return record.id;
+      }
+    }
+  }
+  return targetId || rawSpec || rawTargetId;
 }
 function sanitizeMarketplaceItem(item) {
   const next = { ...item };
@@ -1022,7 +1065,8 @@ async function manageMarketplaceItem(params) {
   const type = params.body.type;
   const action = params.body.action;
   const requestedTargetId = typeof params.body.id === "string" && params.body.id.trim().length > 0 ? params.body.id.trim() : typeof params.body.spec === "string" && params.body.spec.trim().length > 0 ? params.body.spec.trim() : "";
-  const targetId = type === "plugin" ? resolvePluginManageTargetId(params.options, requestedTargetId) : requestedTargetId;
+  const rawSpec = typeof params.body.spec === "string" ? params.body.spec.trim() : "";
+  const targetId = type === "plugin" ? resolvePluginManageTargetId(params.options, requestedTargetId, rawSpec) : requestedTargetId;
   if (type !== "plugin" && type !== "skill" || action !== "enable" && action !== "disable" && action !== "uninstall" || !targetId) {
     throw new Error("INVALID_BODY:type, action and non-empty id/spec are required");
   }
@@ -1294,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") {
@@ -1353,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.3",
+  "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",