@nextclaw/server 0.4.11 → 0.4.12

package/dist/index.d.ts

@@ -53,6 +53,38 @@ type SessionConfigView = {
         maxPingPongTurns?: number;
     };
 };
+type SessionEntryView = {
+    key: string;
+    createdAt: string;
+    updatedAt: string;
+    label?: string;
+    preferredModel?: string;
+    messageCount: number;
+    lastRole?: string;
+    lastTimestamp?: string;
+};
+type SessionsListView = {
+    sessions: SessionEntryView[];
+    total: number;
+};
+type SessionMessageView = {
+    role: string;
+    content: string;
+    timestamp: string;
+    name?: string;
+    tool_call_id?: string;
+};
+type SessionHistoryView = {
+    key: string;
+    totalMessages: number;
+    metadata: Record<string, unknown>;
+    messages: SessionMessageView[];
+};
+type SessionPatchUpdate = {
+    label?: string | null;
+    preferredModel?: string | null;
+    clearHistory?: boolean;
+};
 type RuntimeConfigUpdate = {
     agents?: {
         defaults?: {
@@ -239,6 +271,14 @@ declare function loadConfigOrDefault(configPath: string): Config;
 declare function updateModel(configPath: string, model: string): ConfigView;
 declare function updateProvider(configPath: string, providerName: string, patch: ProviderConfigUpdate): ProviderConfigView | null;
 declare function updateChannel(configPath: string, channelName: string, patch: Record<string, unknown>): Record<string, unknown> | null;
+declare function listSessions(configPath: string, query?: {
+    q?: string;
+    limit?: number;
+    activeMinutes?: number;
+}): SessionsListView;
+declare function getSessionHistory(configPath: string, key: string, limit?: number): SessionHistoryView | null;
+declare function patchSession(configPath: string, key: string, patch: SessionPatchUpdate): SessionHistoryView | null;
+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 ProviderConfigUpdate, type ProviderConfigView, type ProviderSpecView, type RuntimeConfigUpdate, type SessionConfigView, type UiServerEvent, type UiServerHandle, type UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createUiRouter, executeConfigAction, loadConfigOrDefault, 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 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

@@ -20,7 +20,9 @@ import {
   buildConfigSchema,
   findProviderByName,
   getPackageVersion,
-  isSensitiveConfigPath
+  isSensitiveConfigPath,
+  SessionManager,
+  getWorkspacePathFromConfig
 } from "@nextclaw/core";
 var MASK_MIN_LENGTH = 8;
 var EXTRA_SENSITIVE_PATH_PATTERNS = [/authorization/i, /cookie/i, /session/i, /bearer/i];
@@ -391,6 +393,137 @@ function updateChannel(configPath, channelName, patch) {
     uiHints
   );
 }
+function normalizeSessionKey(value) {
+  return value.trim();
+}
+function createSessionManager(config) {
+  return new SessionManager(getWorkspacePathFromConfig(config));
+}
+function listSessions(configPath, query) {
+  const config = loadConfigOrDefault(configPath);
+  const sessionManager = createSessionManager(config);
+  const now = Date.now();
+  const activeMinutes = typeof query?.activeMinutes === "number" ? Math.max(0, Math.trunc(query.activeMinutes)) : 0;
+  const q = (query?.q ?? "").trim().toLowerCase();
+  const limit = typeof query?.limit === "number" ? Math.max(0, Math.trunc(query.limit)) : 0;
+  const entries = sessionManager.listSessions().map((item) => {
+    const key = typeof item.key === "string" ? normalizeSessionKey(item.key) : "";
+    if (!key) {
+      return null;
+    }
+    const session = sessionManager.getIfExists(key);
+    const messages = session?.messages ?? [];
+    const lastMessage = messages.length > 0 ? messages[messages.length - 1] : null;
+    const metadata = item.metadata && typeof item.metadata === "object" ? item.metadata : {};
+    const label = typeof metadata.label === "string" ? metadata.label.trim() : "";
+    const preferredModel = typeof metadata.preferred_model === "string" ? metadata.preferred_model.trim() : "";
+    const createdAt = typeof item.created_at === "string" ? item.created_at : (/* @__PURE__ */ new Date(0)).toISOString();
+    const updatedAt = typeof item.updated_at === "string" ? item.updated_at : createdAt;
+    return {
+      key,
+      createdAt,
+      updatedAt,
+      label: label || void 0,
+      preferredModel: preferredModel || void 0,
+      messageCount: messages.length,
+      lastRole: typeof lastMessage?.role === "string" ? lastMessage.role : void 0,
+      lastTimestamp: typeof lastMessage?.timestamp === "string" ? lastMessage.timestamp : void 0
+    };
+  }).filter((item) => Boolean(item));
+  const filtered = entries.filter((entry) => {
+    if (activeMinutes > 0) {
+      const ageMs = now - new Date(entry.updatedAt).getTime();
+      if (!Number.isFinite(ageMs) || ageMs > activeMinutes * 6e4) {
+        return false;
+      }
+    }
+    if (!q) {
+      return true;
+    }
+    return entry.key.toLowerCase().includes(q) || (entry.label ?? "").toLowerCase().includes(q);
+  });
+  filtered.sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
+  const total = filtered.length;
+  const sessions = limit > 0 ? filtered.slice(0, limit) : filtered;
+  return { sessions, total };
+}
+function getSessionHistory(configPath, key, limit) {
+  const normalizedKey = normalizeSessionKey(key);
+  if (!normalizedKey) {
+    return null;
+  }
+  const config = loadConfigOrDefault(configPath);
+  const sessionManager = createSessionManager(config);
+  const session = sessionManager.getIfExists(normalizedKey);
+  if (!session) {
+    return null;
+  }
+  const safeLimit = typeof limit === "number" ? Math.min(500, Math.max(1, Math.trunc(limit))) : 200;
+  const allMessages = session.messages;
+  const messages = allMessages.length > safeLimit ? allMessages.slice(-safeLimit) : allMessages;
+  return {
+    key: normalizedKey,
+    totalMessages: allMessages.length,
+    metadata: session.metadata,
+    messages: messages.map((message) => {
+      const entry = {
+        role: message.role,
+        content: message.content,
+        timestamp: message.timestamp
+      };
+      if (typeof message.name === "string") {
+        entry.name = message.name;
+      }
+      if (typeof message.tool_call_id === "string") {
+        entry.tool_call_id = message.tool_call_id;
+      }
+      return entry;
+    })
+  };
+}
+function patchSession(configPath, key, patch) {
+  const normalizedKey = normalizeSessionKey(key);
+  if (!normalizedKey) {
+    return null;
+  }
+  const config = loadConfigOrDefault(configPath);
+  const sessionManager = createSessionManager(config);
+  const session = sessionManager.getIfExists(normalizedKey);
+  if (!session) {
+    return null;
+  }
+  if (patch.clearHistory) {
+    sessionManager.clear(session);
+  }
+  if (Object.prototype.hasOwnProperty.call(patch, "label")) {
+    const label = typeof patch.label === "string" ? patch.label.trim() : "";
+    if (label) {
+      session.metadata.label = label;
+    } else {
+      delete session.metadata.label;
+    }
+  }
+  if (Object.prototype.hasOwnProperty.call(patch, "preferredModel")) {
+    const preferredModel = typeof patch.preferredModel === "string" ? patch.preferredModel.trim() : "";
+    if (preferredModel) {
+      session.metadata.preferred_model = preferredModel;
+    } else {
+      delete session.metadata.preferred_model;
+    }
+  }
+  session.updatedAt = /* @__PURE__ */ new Date();
+  sessionManager.save(session);
+  return getSessionHistory(configPath, normalizedKey, 200);
+}
+function deleteSession(configPath, key) {
+  const normalizedKey = normalizeSessionKey(key);
+  if (!normalizedKey) {
+    return false;
+  }
+  const config = loadConfigOrDefault(configPath);
+  const sessionManager = createSessionManager(config);
+  return sessionManager.delete(normalizedKey);
+}
 function updateRuntime(configPath, patch) {
   const config = loadConfigOrDefault(configPath);
   if (patch.agents?.defaults && Object.prototype.hasOwnProperty.call(patch.agents.defaults, "contextTokens")) {
@@ -495,6 +628,50 @@ function createUiRouter(options) {
     options.publish({ type: "config.updated", payload: { path: `channels.${channel}` } });
     return c.json(ok(result));
   });
+  app.get("/api/sessions", (c) => {
+    const query = c.req.query();
+    const q = typeof query.q === "string" ? query.q : void 0;
+    const limit = typeof query.limit === "string" ? Number.parseInt(query.limit, 10) : void 0;
+    const activeMinutes = typeof query.activeMinutes === "string" ? Number.parseInt(query.activeMinutes, 10) : void 0;
+    const data = listSessions(options.configPath, {
+      q,
+      limit: Number.isFinite(limit) ? limit : void 0,
+      activeMinutes: Number.isFinite(activeMinutes) ? activeMinutes : void 0
+    });
+    return c.json(ok(data));
+  });
+  app.get("/api/sessions/:key/history", (c) => {
+    const key = decodeURIComponent(c.req.param("key"));
+    const query = c.req.query();
+    const limit = typeof query.limit === "string" ? Number.parseInt(query.limit, 10) : void 0;
+    const data = getSessionHistory(options.configPath, key, Number.isFinite(limit) ? limit : void 0);
+    if (!data) {
+      return c.json(err("NOT_FOUND", `session not found: ${key}`), 404);
+    }
+    return c.json(ok(data));
+  });
+  app.put("/api/sessions/:key", async (c) => {
+    const key = decodeURIComponent(c.req.param("key"));
+    const body = await readJson(c.req.raw);
+    if (!body.ok || !body.data || typeof body.data !== "object") {
+      return c.json(err("INVALID_BODY", "invalid json body"), 400);
+    }
+    const data = patchSession(options.configPath, key, body.data);
+    if (!data) {
+      return c.json(err("NOT_FOUND", `session not found: ${key}`), 404);
+    }
+    options.publish({ type: "config.updated", payload: { path: "session" } });
+    return c.json(ok(data));
+  });
+  app.delete("/api/sessions/:key", (c) => {
+    const key = decodeURIComponent(c.req.param("key"));
+    const deleted = deleteSession(options.configPath, key);
+    if (!deleted) {
+      return c.json(err("NOT_FOUND", `session not found: ${key}`), 404);
+    }
+    options.publish({ type: "config.updated", payload: { path: "session" } });
+    return c.json(ok({ deleted: true }));
+  });
   app.put("/api/config/runtime", async (c) => {
     const body = await readJson(c.req.raw);
     if (!body.ok || !body.data || typeof body.data !== "object") {
@@ -616,8 +793,12 @@ export {
   buildConfigSchemaView,
   buildConfigView,
   createUiRouter,
+  deleteSession,
   executeConfigAction,
+  getSessionHistory,
+  listSessions,
   loadConfigOrDefault,
+  patchSession,
   startUiServer,
   updateChannel,
   updateModel,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/server",
-  "version": "0.4.11",
+  "version": "0.4.12",
   "private": false,
   "description": "Nextclaw UI/API server.",
   "type": "module",