@nextclaw/server 0.6.0 → 0.6.2

package/dist/index.d.ts

@@ -278,9 +278,42 @@ type ChatTurnStopResult = {
     sessionKey?: string;
     reason?: string;
 };
+type ChatRunState = "queued" | "running" | "completed" | "failed" | "aborted";
+type ChatRunView = {
+    runId: string;
+    sessionKey: string;
+    agentId?: string;
+    model?: string;
+    state: ChatRunState;
+    requestedAt: string;
+    startedAt?: string;
+    completedAt?: string;
+    stopSupported: boolean;
+    stopReason?: string;
+    error?: string;
+    reply?: string;
+    eventCount: number;
+};
+type ChatRunListView = {
+    runs: ChatRunView[];
+    total: number;
+};
 type UiChatRuntime = {
     processTurn: (params: ChatTurnRequest) => Promise<ChatTurnResult>;
     processTurnStream?: (params: ChatTurnRequest) => AsyncGenerator<ChatTurnStreamEvent>;
+    startTurnRun?: (params: ChatTurnRequest) => Promise<ChatRunView> | ChatRunView;
+    streamRun?: (params: {
+        runId: string;
+        fromEventIndex?: number;
+    }) => AsyncGenerator<ChatTurnStreamEvent>;
+    getRun?: (params: {
+        runId: string;
+    }) => Promise<ChatRunView | null> | ChatRunView | null;
+    listRuns?: (params: {
+        sessionKey?: string;
+        states?: ChatRunState[];
+        limit?: number;
+    }) => Promise<ChatRunListView> | ChatRunListView;
     getCapabilities?: (params: Pick<ChatTurnRequest, "sessionKey" | "agentId">) => Promise<ChatCapabilitiesView> | ChatCapabilitiesView;
     stopTurn?: (params: ChatTurnStopRequest) => Promise<ChatTurnStopResult> | ChatTurnStopResult;
 };
@@ -598,6 +631,11 @@ type UiServerEvent = {
     payload: {
         path: string;
     };
+} | {
+    type: "run.updated";
+    payload: {
+        run: ChatRunView;
+    };
 } | {
     type: "config.reload.started";
     payload?: Record<string, unknown>;
@@ -675,4 +713,4 @@ 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 BindingPeerView, type ChannelSpecView, type ChatCapabilitiesView, 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 MarketplacePluginInstallRequest, type MarketplacePluginInstallResult, type MarketplacePluginManageAction, type MarketplacePluginManageRequest, type MarketplacePluginManageResult, type MarketplaceRecommendationView, type MarketplaceSkillContentView, type MarketplaceSkillInstallRequest, type MarketplaceSkillInstallResult, type MarketplaceSkillManageAction, type MarketplaceSkillManageRequest, type MarketplaceSkillManageResult, type MarketplaceSort, 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 BindingPeerView, type ChannelSpecView, type ChatCapabilitiesView, 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 MarketplacePluginInstallRequest, type MarketplacePluginInstallResult, type MarketplacePluginManageAction, type MarketplacePluginManageRequest, type MarketplacePluginManageResult, type MarketplaceRecommendationView, type MarketplaceSkillContentView, type MarketplaceSkillInstallRequest, type MarketplaceSkillInstallResult, type MarketplaceSkillManageAction, type MarketplaceSkillManageRequest, type MarketplaceSkillManageResult, type MarketplaceSort, 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 };

package/dist/index.js

@@ -34,6 +34,7 @@ import {
 var MASK_MIN_LENGTH = 8;
 var EXTRA_SENSITIVE_PATH_PATTERNS = [/authorization/i, /cookie/i, /session/i, /bearer/i];
 var PROVIDER_TEST_MODEL_FALLBACKS = {
+  nextclaw: "dashscope/qwen3.5-flash",
   openai: "gpt-5-mini",
   deepseek: "deepseek-chat",
   gemini: "gemini-3-flash-preview",
@@ -47,6 +48,7 @@ var PROVIDER_TEST_MODEL_FALLBACKS = {
   anthropic: "claude-opus-4-6"
 };
 var PREFERRED_PROVIDER_ORDER = [
+  "nextclaw",
   "openai",
   "anthropic",
   "gemini",
@@ -1193,6 +1195,19 @@ function createChatRunId() {
   const rand = Math.random().toString(36).slice(2, 10);
   return `run-${now}-${rand}`;
 }
+function isChatRunState(value) {
+  return value === "queued" || value === "running" || value === "completed" || value === "failed" || value === "aborted";
+}
+function readChatRunStates(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const values = value.split(",").map((item) => item.trim().toLowerCase()).filter((item) => Boolean(item) && isChatRunState(item));
+  if (values.length === 0) {
+    return void 0;
+  }
+  return Array.from(new Set(values));
+}
 function buildChatTurnView(params) {
   const completedAt = /* @__PURE__ */ new Date();
   return {
@@ -1205,6 +1220,21 @@ function buildChatTurnView(params) {
     durationMs: Math.max(0, completedAt.getTime() - params.startedAtMs)
   };
 }
+function buildChatTurnViewFromRun(params) {
+  const requestedAt = readNonEmptyString(params.run.requestedAt) ?? (/* @__PURE__ */ new Date()).toISOString();
+  const completedAt = readNonEmptyString(params.run.completedAt) ?? (/* @__PURE__ */ new Date()).toISOString();
+  const requestedAtMs = Date.parse(requestedAt);
+  const completedAtMs = Date.parse(completedAt);
+  return {
+    reply: readNonEmptyString(params.run.reply) ?? params.fallbackReply ?? "",
+    sessionKey: readNonEmptyString(params.run.sessionKey) ?? params.fallbackSessionKey,
+    ...readNonEmptyString(params.run.agentId) || params.fallbackAgentId ? { agentId: readNonEmptyString(params.run.agentId) ?? params.fallbackAgentId } : {},
+    ...readNonEmptyString(params.run.model) || params.fallbackModel ? { model: readNonEmptyString(params.run.model) ?? params.fallbackModel } : {},
+    requestedAt,
+    completedAt,
+    durationMs: Number.isFinite(requestedAtMs) && Number.isFinite(completedAtMs) ? Math.max(0, completedAtMs - requestedAtMs) : 0
+  };
+}
 function toSseFrame(event, data) {
   return `event: ${event}
 data: ${JSON.stringify(data)}
@@ -2466,7 +2496,8 @@ function createUiRouter(options) {
     const metadata = isRecord(body.data.metadata) ? body.data.metadata : void 0;
     const requestedAgentId = readNonEmptyString(body.data.agentId) ?? resolveAgentIdFromSessionKey(sessionKey);
     const requestedModel = readNonEmptyString(body.data.model);
-    const runId = createChatRunId();
+    let runId = createChatRunId();
+    const supportsManagedRuns = Boolean(chatRuntime.startTurnRun && chatRuntime.streamRun);
     let stopCapabilities = { stopSupported: Boolean(chatRuntime.stopTurn) };
     if (chatRuntime.getCapabilities) {
       try {
@@ -2491,6 +2522,21 @@ function createUiRouter(options) {
       ...requestedModel ? { model: requestedModel } : {},
       ...metadata ? { metadata } : {}
     };
+    let managedRun = null;
+    if (supportsManagedRuns && chatRuntime.startTurnRun) {
+      try {
+        managedRun = await chatRuntime.startTurnRun(request);
+      } catch (error) {
+        return c.json(err("CHAT_TURN_FAILED", String(error)), 500);
+      }
+      if (readNonEmptyString(managedRun.runId)) {
+        runId = readNonEmptyString(managedRun.runId);
+      }
+      stopCapabilities = {
+        stopSupported: managedRun.stopSupported,
+        ...readNonEmptyString(managedRun.stopReason) ? { stopReason: readNonEmptyString(managedRun.stopReason) } : {}
+      };
+    }
     const encoder = new TextEncoder();
     const stream = new ReadableStream({
       start: async (controller) => {
@@ -2499,12 +2545,65 @@ function createUiRouter(options) {
         };
         try {
           push("ready", {
-            sessionKey,
-            requestedAt: requestedAt.toISOString(),
+            sessionKey: managedRun?.sessionKey ?? sessionKey,
+            requestedAt: managedRun?.requestedAt ?? requestedAt.toISOString(),
             runId,
             stopSupported: stopCapabilities.stopSupported,
             ...readNonEmptyString(stopCapabilities.stopReason) ? { stopReason: readNonEmptyString(stopCapabilities.stopReason) } : {}
           });
+          if (supportsManagedRuns && chatRuntime.streamRun) {
+            let hasFinal2 = false;
+            for await (const event of chatRuntime.streamRun({ runId })) {
+              const typed = event;
+              if (typed.type === "delta") {
+                if (typed.delta) {
+                  push("delta", { delta: typed.delta });
+                }
+                continue;
+              }
+              if (typed.type === "session_event") {
+                push("session_event", typed.event);
+                continue;
+              }
+              if (typed.type === "final") {
+                const latestRun = chatRuntime.getRun ? await chatRuntime.getRun({ runId }) : null;
+                const response = latestRun ? buildChatTurnViewFromRun({
+                  run: latestRun,
+                  fallbackSessionKey: sessionKey,
+                  fallbackAgentId: requestedAgentId,
+                  fallbackModel: requestedModel,
+                  fallbackReply: typed.result.reply
+                }) : buildChatTurnView({
+                  result: typed.result,
+                  fallbackSessionKey: sessionKey,
+                  requestedAgentId,
+                  requestedModel,
+                  requestedAt,
+                  startedAtMs
+                });
+                hasFinal2 = true;
+                push("final", response);
+                options.publish({ type: "config.updated", payload: { path: "session" } });
+                continue;
+              }
+              if (typed.type === "error") {
+                push("error", {
+                  code: "CHAT_TURN_FAILED",
+                  message: typed.error
+                });
+                return;
+              }
+            }
+            if (!hasFinal2) {
+              push("error", {
+                code: "CHAT_TURN_FAILED",
+                message: "stream ended without a final result"
+              });
+              return;
+            }
+            push("done", { ok: true });
+            return;
+          }
           const streamTurn = chatRuntime.processTurnStream;
           if (!streamTurn) {
             const result = await chatRuntime.processTurn(request);
@@ -2584,6 +2683,151 @@ function createUiRouter(options) {
       }
     });
   });
+  app.get("/api/chat/runs", async (c) => {
+    const chatRuntime = options.chatRuntime;
+    if (!chatRuntime?.listRuns) {
+      return c.json(err("NOT_AVAILABLE", "chat run management unavailable"), 503);
+    }
+    const query = c.req.query();
+    const sessionKey = readNonEmptyString(query.sessionKey);
+    const states = readChatRunStates(query.states);
+    const limit = typeof query.limit === "string" ? Number.parseInt(query.limit, 10) : void 0;
+    try {
+      const data = await chatRuntime.listRuns({
+        ...sessionKey ? { sessionKey } : {},
+        ...states ? { states } : {},
+        ...Number.isFinite(limit) ? { limit } : {}
+      });
+      return c.json(ok(data));
+    } catch (error) {
+      return c.json(err("CHAT_RUN_QUERY_FAILED", String(error)), 500);
+    }
+  });
+  app.get("/api/chat/runs/:runId", async (c) => {
+    const chatRuntime = options.chatRuntime;
+    if (!chatRuntime?.getRun) {
+      return c.json(err("NOT_AVAILABLE", "chat run management unavailable"), 503);
+    }
+    const runId = readNonEmptyString(c.req.param("runId"));
+    if (!runId) {
+      return c.json(err("INVALID_PATH", "runId is required"), 400);
+    }
+    try {
+      const run = await chatRuntime.getRun({ runId });
+      if (!run) {
+        return c.json(err("NOT_FOUND", `chat run not found: ${runId}`), 404);
+      }
+      return c.json(ok(run));
+    } catch (error) {
+      return c.json(err("CHAT_RUN_QUERY_FAILED", String(error)), 500);
+    }
+  });
+  app.get("/api/chat/runs/:runId/stream", async (c) => {
+    const chatRuntime = options.chatRuntime;
+    const streamRun = chatRuntime?.streamRun;
+    const getRun = chatRuntime?.getRun;
+    if (!streamRun || !getRun) {
+      return c.json(err("NOT_AVAILABLE", "chat run stream unavailable"), 503);
+    }
+    const runId = readNonEmptyString(c.req.param("runId"));
+    if (!runId) {
+      return c.json(err("INVALID_PATH", "runId is required"), 400);
+    }
+    const query = c.req.query();
+    const fromEventIndex = typeof query.fromEventIndex === "string" ? Number.parseInt(query.fromEventIndex, 10) : void 0;
+    const run = await getRun({ runId });
+    if (!run) {
+      return c.json(err("NOT_FOUND", `chat run not found: ${runId}`), 404);
+    }
+    const encoder = new TextEncoder();
+    const stream = new ReadableStream({
+      start: async (controller) => {
+        const push = (event, data) => {
+          controller.enqueue(encoder.encode(toSseFrame(event, data)));
+        };
+        try {
+          push("ready", {
+            sessionKey: run.sessionKey,
+            requestedAt: run.requestedAt,
+            runId: run.runId,
+            stopSupported: run.stopSupported,
+            ...readNonEmptyString(run.stopReason) ? { stopReason: readNonEmptyString(run.stopReason) } : {}
+          });
+          let hasFinal = false;
+          for await (const event of streamRun({
+            runId: run.runId,
+            ...Number.isFinite(fromEventIndex) ? { fromEventIndex } : {}
+          })) {
+            const typed = event;
+            if (typed.type === "delta") {
+              if (typed.delta) {
+                push("delta", { delta: typed.delta });
+              }
+              continue;
+            }
+            if (typed.type === "session_event") {
+              push("session_event", typed.event);
+              continue;
+            }
+            if (typed.type === "final") {
+              const latestRun = await getRun({ runId: run.runId });
+              const response = latestRun ? buildChatTurnViewFromRun({
+                run: latestRun,
+                fallbackSessionKey: run.sessionKey,
+                fallbackAgentId: run.agentId,
+                fallbackModel: run.model,
+                fallbackReply: typed.result.reply
+              }) : buildChatTurnView({
+                result: typed.result,
+                fallbackSessionKey: run.sessionKey,
+                requestedAgentId: run.agentId,
+                requestedModel: run.model,
+                requestedAt: new Date(run.requestedAt),
+                startedAtMs: Date.parse(run.requestedAt)
+              });
+              hasFinal = true;
+              push("final", response);
+              continue;
+            }
+            if (typed.type === "error") {
+              push("error", {
+                code: "CHAT_TURN_FAILED",
+                message: typed.error
+              });
+              return;
+            }
+          }
+          if (!hasFinal) {
+            const latestRun = await getRun({ runId: run.runId });
+            if (latestRun?.state === "failed") {
+              push("error", {
+                code: "CHAT_TURN_FAILED",
+                message: latestRun.error ?? "chat run failed"
+              });
+              return;
+            }
+          }
+          push("done", { ok: true });
+        } catch (error) {
+          push("error", {
+            code: "CHAT_TURN_FAILED",
+            message: String(error)
+          });
+        } finally {
+          controller.close();
+        }
+      }
+    });
+    return new Response(stream, {
+      status: 200,
+      headers: {
+        "Content-Type": "text/event-stream; charset=utf-8",
+        "Cache-Control": "no-cache, no-transform",
+        "Connection": "keep-alive",
+        "X-Accel-Buffering": "no"
+      }
+    });
+  });
   app.get("/api/sessions", (c) => {
     const query = c.req.query();
     const q = typeof query.q === "string" ? query.q : void 0;

package/package.json

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