@nextclaw/server 0.6.7 → 0.6.8

package/dist/index.d.ts

@@ -117,6 +117,8 @@ type SessionEntryView = {
     updatedAt: string;
     label?: string;
     preferredModel?: string;
+    sessionType: string;
+    sessionTypeMutable: boolean;
     messageCount: number;
     lastRole?: string;
     lastTimestamp?: string;
@@ -144,6 +146,8 @@ type SessionHistoryView = {
     key: string;
     totalMessages: number;
     totalEvents: number;
+    sessionType: string;
+    sessionTypeMutable: boolean;
     metadata: Record<string, unknown>;
     messages: SessionMessageView[];
     events: SessionEventView[];
@@ -151,6 +155,7 @@ type SessionHistoryView = {
 type SessionPatchUpdate = {
     label?: string | null;
     preferredModel?: string | null;
+    sessionType?: string | null;
     clearHistory?: boolean;
 };
 type CronScheduleView = {
@@ -300,6 +305,14 @@ type ChatCapabilitiesView = {
     stopSupported: boolean;
     stopReason?: string;
 };
+type ChatSessionTypeOptionView = {
+    value: string;
+    label: string;
+};
+type ChatSessionTypesView = {
+    defaultType: string;
+    options: ChatSessionTypeOptionView[];
+};
 type ChatCommandOptionView = {
     name: string;
     description: string;
@@ -363,6 +376,7 @@ type UiChatRuntime = {
         limit?: number;
     }) => Promise<ChatRunListView> | ChatRunListView;
     getCapabilities?: (params: Pick<ChatTurnRequest, "sessionKey" | "agentId">) => Promise<ChatCapabilitiesView> | ChatCapabilitiesView;
+    listSessionTypes?: () => Promise<ChatSessionTypesView> | ChatSessionTypesView;
     stopTurn?: (params: ChatTurnStopRequest) => Promise<ChatTurnStopResult> | ChatTurnStopResult;
 };
 type ConfigView = {
@@ -781,15 +795,22 @@ declare function createCustomProvider(configPath: string, patch?: ProviderConfig
 declare function deleteCustomProvider(configPath: string, providerName: string): boolean | null;
 declare function testProviderConnection(configPath: string, providerName: string, patch: ProviderConnectionTestRequest): Promise<ProviderConnectionTestResult | null>;
 declare function updateChannel(configPath: string, channelName: string, patch: Record<string, unknown>): Record<string, unknown> | null;
+declare const DEFAULT_SESSION_TYPE = "native";
+declare class SessionPatchValidationError extends Error {
+    readonly code: "SESSION_TYPE_INVALID" | "SESSION_TYPE_IMMUTABLE" | "SESSION_TYPE_UNAVAILABLE";
+    constructor(code: "SESSION_TYPE_INVALID" | "SESSION_TYPE_IMMUTABLE" | "SESSION_TYPE_UNAVAILABLE", message: string);
+}
 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 patchSession(configPath: string, key: string, patch: SessionPatchUpdate, options?: {
+    availableSessionTypes?: string[];
+}): SessionHistoryView | null;
 declare function deleteSession(configPath: string, key: string): boolean;
 declare function updateRuntime(configPath: string, patch: RuntimeConfigUpdate): Pick<ConfigView, "agents" | "bindings" | "session">;
 declare function updateSecrets(configPath: string, patch: SecretsConfigUpdate): SecretsView;
 
-export { type AgentBindingView, type AgentProfileView, type ApiError, type ApiResponse, type AppMetaView, type BindingPeerView, type ChannelSpecView, type ChatCapabilitiesView, type ChatCommandOptionView, type ChatCommandView, type ChatCommandsView, type ChatRunListView, type ChatRunState, type ChatRunView, type ChatTurnRequest, type ChatTurnResult, type ChatTurnStopRequest, type ChatTurnStopResult, type ChatTurnStreamEvent, type ChatTurnView, 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 MarketplaceInstallSkillParams, type MarketplaceInstallSpec, type MarketplaceInstalledRecord, type MarketplaceInstalledView, type MarketplaceInstaller, type MarketplaceItemSummary, type MarketplaceItemType, type MarketplaceItemView, type MarketplaceListView, type MarketplaceLocalizedTextMap, type MarketplacePluginContentView, type MarketplacePluginInstallKind, type MarketplacePluginInstallRequest, type MarketplacePluginInstallResult, type MarketplacePluginManageAction, type MarketplacePluginManageRequest, type MarketplacePluginManageResult, type MarketplaceRecommendationView, type MarketplaceSkillContentView, type MarketplaceSkillInstallKind, type MarketplaceSkillInstallRequest, type MarketplaceSkillInstallResult, type MarketplaceSkillManageAction, type MarketplaceSkillManageRequest, type MarketplaceSkillManageResult, type MarketplaceSort, type ProviderAuthImportResult, type ProviderAuthPollRequest, type ProviderAuthPollResult, type ProviderAuthStartRequest, type ProviderAuthStartResult, type ProviderConfigUpdate, type ProviderConfigView, type ProviderConnectionTestRequest, type ProviderConnectionTestResult, type ProviderCreateRequest, type ProviderCreateResult, type ProviderDeleteResult, type ProviderSpecView, type RuntimeConfigUpdate, type SecretProviderEnvView, type SecretProviderExecView, type SecretProviderFileView, type SecretProviderView, type SecretRefView, type SecretSourceView, type SecretsConfigUpdate, type SecretsView, type SessionConfigView, type SessionEntryView, type SessionEventView, type SessionHistoryView, type SessionMessageView, type SessionPatchUpdate, type SessionsListView, type UiChatRuntime, type UiServerEvent, type UiServerHandle, type UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createCustomProvider, createUiRouter, deleteCustomProvider, deleteSession, executeConfigAction, getSessionHistory, listSessions, loadConfigOrDefault, patchSession, startUiServer, testProviderConnection, updateChannel, updateModel, updateProvider, updateRuntime, updateSecrets };
+export { type AgentBindingView, type AgentProfileView, type ApiError, type ApiResponse, type AppMetaView, type BindingPeerView, type ChannelSpecView, type ChatCapabilitiesView, type ChatCommandOptionView, type ChatCommandView, type ChatCommandsView, type ChatRunListView, type ChatRunState, type ChatRunView, type ChatSessionTypeOptionView, type ChatSessionTypesView, type ChatTurnRequest, type ChatTurnResult, type ChatTurnStopRequest, type ChatTurnStopResult, type ChatTurnStreamEvent, type ChatTurnView, 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, DEFAULT_SESSION_TYPE, type MarketplaceApiConfig, type MarketplaceInstallKind, type MarketplaceInstallSkillParams, type MarketplaceInstallSpec, type MarketplaceInstalledRecord, type MarketplaceInstalledView, type MarketplaceInstaller, type MarketplaceItemSummary, type MarketplaceItemType, type MarketplaceItemView, type MarketplaceListView, type MarketplaceLocalizedTextMap, type MarketplacePluginContentView, type MarketplacePluginInstallKind, type MarketplacePluginInstallRequest, type MarketplacePluginInstallResult, type MarketplacePluginManageAction, type MarketplacePluginManageRequest, type MarketplacePluginManageResult, type MarketplaceRecommendationView, type MarketplaceSkillContentView, type MarketplaceSkillInstallKind, type MarketplaceSkillInstallRequest, type MarketplaceSkillInstallResult, type MarketplaceSkillManageAction, type MarketplaceSkillManageRequest, type MarketplaceSkillManageResult, type MarketplaceSort, type ProviderAuthImportResult, type ProviderAuthPollRequest, type ProviderAuthPollResult, type ProviderAuthStartRequest, type ProviderAuthStartResult, type ProviderConfigUpdate, type ProviderConfigView, type ProviderConnectionTestRequest, type ProviderConnectionTestResult, type ProviderCreateRequest, type ProviderCreateResult, type ProviderDeleteResult, type ProviderSpecView, type RuntimeConfigUpdate, type SecretProviderEnvView, type SecretProviderExecView, type SecretProviderFileView, type SecretProviderView, type SecretRefView, type SecretSourceView, type SecretsConfigUpdate, type SecretsView, type SessionConfigView, type SessionEntryView, type SessionEventView, type SessionHistoryView, type SessionMessageView, type SessionPatchUpdate, SessionPatchValidationError, type SessionsListView, type UiChatRuntime, type UiServerEvent, type UiServerHandle, type UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createCustomProvider, createUiRouter, deleteCustomProvider, deleteSession, executeConfigAction, getSessionHistory, listSessions, loadConfigOrDefault, patchSession, startUiServer, testProviderConnection, updateChannel, updateModel, updateProvider, updateRuntime, updateSecrets };

package/dist/index.js

@@ -875,6 +875,36 @@ function normalizeSessionKey(value) {
 function createSessionManager(config) {
   return new SessionManager(getWorkspacePathFromConfig(config));
 }
+var DEFAULT_SESSION_TYPE = "native";
+var SESSION_TYPE_METADATA_KEY = "session_type";
+function normalizeSessionType(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const normalized = value.trim().toLowerCase();
+  return normalized.length > 0 ? normalized : null;
+}
+function readSessionType(session) {
+  const normalized = normalizeSessionType(session.metadata[SESSION_TYPE_METADATA_KEY]);
+  return normalized ?? DEFAULT_SESSION_TYPE;
+}
+function countUserMessages(session) {
+  return session.messages.reduce((total, message) => {
+    const role = typeof message.role === "string" ? message.role.trim().toLowerCase() : "";
+    return role === "user" ? total + 1 : total;
+  }, 0);
+}
+function isSessionTypeMutable(session) {
+  const activeUiRunId = typeof session.metadata.ui_active_run_id === "string" ? session.metadata.ui_active_run_id.trim() : "";
+  return countUserMessages(session) === 0 && activeUiRunId.length === 0;
+}
+var SessionPatchValidationError = class extends Error {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    this.name = "SessionPatchValidationError";
+  }
+};
 function listSessions(configPath, query) {
   const config = loadConfigOrDefault(configPath);
   const sessionManager = createSessionManager(config);
@@ -895,12 +925,22 @@ function listSessions(configPath, query) {
     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;
+    const sessionType = readSessionType({
+      metadata,
+      messages
+    });
+    const sessionTypeMutable = isSessionTypeMutable({
+      metadata,
+      messages
+    });
     return {
       key,
       createdAt,
       updatedAt,
       label: label || void 0,
       preferredModel: preferredModel || void 0,
+      sessionType,
+      sessionTypeMutable,
       messageCount: messages.length,
       lastRole: typeof lastMessage?.role === "string" ? lastMessage.role : void 0,
       lastTimestamp: typeof lastMessage?.timestamp === "string" ? lastMessage.timestamp : void 0
@@ -940,10 +980,14 @@ function getSessionHistory(configPath, key, limit) {
   const safeEventLimit = Math.min(2e3, Math.max(50, safeLimit * 4));
   const allEvents = session.events ?? [];
   const events = allEvents.length > safeEventLimit ? allEvents.slice(-safeEventLimit) : allEvents;
+  const sessionType = readSessionType(session);
+  const sessionTypeMutable = isSessionTypeMutable(session);
   return {
     key: normalizedKey,
     totalMessages: allMessages.length,
     totalEvents: allEvents.length,
+    sessionType,
+    sessionTypeMutable,
     metadata: session.metadata,
     messages: messages.map((message) => {
       const entry = {
@@ -990,7 +1034,7 @@ function getSessionHistory(configPath, key, limit) {
     })
   };
 }
-function patchSession(configPath, key, patch) {
+function patchSession(configPath, key, patch, options) {
   const normalizedKey = normalizeSessionKey(key);
   if (!normalizedKey) {
     return null;
@@ -1020,6 +1064,32 @@ function patchSession(configPath, key, patch) {
       delete session.metadata.preferred_model;
     }
   }
+  if (Object.prototype.hasOwnProperty.call(patch, "sessionType")) {
+    const normalizedSessionType = normalizeSessionType(patch.sessionType);
+    if (!normalizedSessionType) {
+      throw new SessionPatchValidationError(
+        "SESSION_TYPE_INVALID",
+        "sessionType must be a non-empty string"
+      );
+    }
+    if (!isSessionTypeMutable(session)) {
+      throw new SessionPatchValidationError(
+        "SESSION_TYPE_IMMUTABLE",
+        "sessionType cannot be changed after the first user message"
+      );
+    }
+    const availableSessionTypes = new Set(
+      (options?.availableSessionTypes ?? [DEFAULT_SESSION_TYPE]).map((item) => normalizeSessionType(item)).filter((item) => Boolean(item))
+    );
+    availableSessionTypes.add(DEFAULT_SESSION_TYPE);
+    if (!availableSessionTypes.has(normalizedSessionType)) {
+      throw new SessionPatchValidationError(
+        "SESSION_TYPE_UNAVAILABLE",
+        `sessionType is unavailable: ${normalizedSessionType}`
+      );
+    }
+    session.metadata[SESSION_TYPE_METADATA_KEY] = normalizedSessionType;
+  }
   session.updatedAt = /* @__PURE__ */ new Date();
   sessionManager.save(session);
   return getSessionHistory(configPath, normalizedKey, 200);
@@ -1851,6 +1921,67 @@ function readNonEmptyString(value) {
   const trimmed = value.trim();
   return trimmed || void 0;
 }
+function normalizeSessionType2(value) {
+  return readNonEmptyString(value)?.toLowerCase();
+}
+function resolveSessionTypeLabel(sessionType) {
+  if (sessionType === "native") {
+    return "Native";
+  }
+  if (sessionType === "codex-sdk") {
+    return "Codex";
+  }
+  if (sessionType === "claude-agent-sdk") {
+    return "Claude Code";
+  }
+  return sessionType;
+}
+async function buildChatSessionTypesView(chatRuntime) {
+  if (!chatRuntime?.listSessionTypes) {
+    return {
+      defaultType: DEFAULT_SESSION_TYPE,
+      options: [{ value: DEFAULT_SESSION_TYPE, label: resolveSessionTypeLabel(DEFAULT_SESSION_TYPE) }]
+    };
+  }
+  const payload = await chatRuntime.listSessionTypes();
+  const deduped = /* @__PURE__ */ new Map();
+  for (const rawOption of payload.options ?? []) {
+    const normalized = normalizeSessionType2(rawOption.value);
+    if (!normalized) {
+      continue;
+    }
+    deduped.set(normalized, {
+      value: normalized,
+      label: readNonEmptyString(rawOption.label) ?? resolveSessionTypeLabel(normalized)
+    });
+  }
+  if (!deduped.has(DEFAULT_SESSION_TYPE)) {
+    deduped.set(DEFAULT_SESSION_TYPE, {
+      value: DEFAULT_SESSION_TYPE,
+      label: resolveSessionTypeLabel(DEFAULT_SESSION_TYPE)
+    });
+  }
+  const defaultType = normalizeSessionType2(payload.defaultType) ?? DEFAULT_SESSION_TYPE;
+  if (!deduped.has(defaultType)) {
+    deduped.set(defaultType, {
+      value: defaultType,
+      label: resolveSessionTypeLabel(defaultType)
+    });
+  }
+  const options = Array.from(deduped.values()).sort((left, right) => {
+    if (left.value === DEFAULT_SESSION_TYPE) {
+      return -1;
+    }
+    if (right.value === DEFAULT_SESSION_TYPE) {
+      return 1;
+    }
+    return left.value.localeCompare(right.value);
+  });
+  return {
+    defaultType,
+    options
+  };
+}
 function resolveAgentIdFromSessionKey(sessionKey) {
   const parsed = NextclawCore.parseAgentScopedSessionKey(sessionKey);
   const agentId = readNonEmptyString(parsed?.agentId);
@@ -3052,6 +3183,14 @@ function createUiRouter(options) {
       return c.json(err("CHAT_RUNTIME_FAILED", String(error)), 500);
     }
   });
+  app.get("/api/chat/session-types", async (c) => {
+    try {
+      const payload = await buildChatSessionTypesView(options.chatRuntime);
+      return c.json(ok(payload));
+    } catch (error) {
+      return c.json(err("CHAT_SESSION_TYPES_FAILED", String(error)), 500);
+    }
+  });
   app.get("/api/chat/commands", async (c) => {
     try {
       const config = loadConfigOrDefault(options.configPath);
@@ -3524,7 +3663,25 @@ function createUiRouter(options) {
     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);
+    let availableSessionTypes;
+    if (Object.prototype.hasOwnProperty.call(body.data, "sessionType")) {
+      const sessionTypes = await buildChatSessionTypesView(options.chatRuntime);
+      availableSessionTypes = sessionTypes.options.map((item) => item.value);
+    }
+    let data;
+    try {
+      data = patchSession(options.configPath, key, body.data, {
+        ...availableSessionTypes ? { availableSessionTypes } : {}
+      });
+    } catch (error) {
+      if (error instanceof SessionPatchValidationError) {
+        if (error.code === "SESSION_TYPE_IMMUTABLE") {
+          return c.json(err(error.code, error.message), 409);
+        }
+        return c.json(err(error.code, error.message), 400);
+      }
+      throw error;
+    }
     if (!data) {
       return c.json(err("NOT_FOUND", `session not found: ${key}`), 404);
     }
@@ -3729,6 +3886,8 @@ function startUiServer(options) {
   };
 }
 export {
+  DEFAULT_SESSION_TYPE,
+  SessionPatchValidationError,
   buildConfigMeta,
   buildConfigSchemaView,
   buildConfigView,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/server",
-  "version": "0.6.7",
+  "version": "0.6.8",
   "private": false,
   "description": "Nextclaw UI/API server.",
   "type": "module",
@@ -17,9 +17,9 @@
     "@hono/node-server": "^1.13.3",
     "hono": "^4.6.2",
     "ws": "^8.18.0",
-    "@nextclaw/openclaw-compat": "0.2.2",
-    "@nextclaw/runtime": "0.1.2",
-    "@nextclaw/core": "0.7.3"
+    "@nextclaw/openclaw-compat": "0.2.3",
+    "@nextclaw/core": "0.7.4",
+    "@nextclaw/runtime": "0.1.3"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",