@nextclaw/server 0.10.55 → 0.10.56

package/dist/index.d.ts

@@ -6,6 +6,29 @@ import { NcpHttpAgentStreamProvider } from '@nextclaw/ncp-http-agent-server';
 import { IncomingMessage } from 'node:http';
 import { Hono } from 'hono';
 
+type UiNcpStoredAttachmentRecord = {
+    id: string;
+    uri: string;
+    storageKey: string;
+    originalName: string;
+    storedName: string;
+    mimeType: string;
+    sizeBytes: number;
+    createdAt: string;
+    sha256: string;
+};
+type UiNcpAttachmentView = {
+    id: string;
+    name: string;
+    mimeType: string;
+    sizeBytes: number;
+    attachmentUri: string;
+    url: string;
+};
+type UiNcpAttachmentUploadView = {
+    attachments: UiNcpAttachmentView[];
+};
+
 type MarketplaceItemType = "plugin" | "skill" | "mcp";
 type MarketplaceSort = "relevance" | "updated";
 type MarketplacePluginInstallKind = "npm";
@@ -942,6 +965,16 @@ type UiNcpAgent = {
     streamProvider?: NcpHttpAgentStreamProvider;
     sessionApi?: NcpSessionApi;
     listSessionTypes?: (params?: SessionTypeDescribeParams) => Promise<ChatSessionTypesView> | ChatSessionTypesView;
+    attachmentApi?: {
+        saveAttachment: (input: {
+            fileName: string;
+            mimeType?: string | null;
+            bytes: Uint8Array;
+            createdAt?: Date;
+        }) => Promise<UiNcpStoredAttachmentRecord>;
+        statAttachment: (uri: string) => Promise<UiNcpStoredAttachmentRecord | null> | UiNcpStoredAttachmentRecord | null;
+        resolveContentPath: (uri: string) => string | null;
+    };
     basePath?: string;
 };
 type ConfigView = {
@@ -1217,4 +1250,4 @@ declare function getUiBridgeSecretPath(): string;
 declare function readUiBridgeSecret(): string | null;
 declare function ensureUiBridgeSecret(): string;
 
-export { type AgentBindingView, type AgentProfileView, type ApiError, type ApiResponse, type AppMetaView, type AuthEnabledUpdateRequest, type AuthLoginRequest, type AuthPasswordUpdateRequest, type AuthSetupRequest, type AuthStatusView, type BindingPeerView, type BochaFreshnessValue, type ChannelAuthPollRequest, type ChannelAuthPollResult, type ChannelAuthStartRequest, type ChannelAuthStartResult, type ChannelSpecView, type ChatCapabilitiesView, type ChatCommandOptionView, type ChatCommandView, type ChatCommandsView, type ChatRunListView, type ChatRunState, type ChatRunView, type ChatSessionTypeCtaView, 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 MarketplaceMcpContentView, type MarketplaceMcpDoctorResult, type MarketplaceMcpInstallKind, type MarketplaceMcpInstallRequest, type MarketplaceMcpInstallResult, type MarketplaceMcpInstallSpec, type MarketplaceMcpManageAction, type MarketplaceMcpManageRequest, type MarketplaceMcpManageResult, type MarketplaceMcpTemplateInput, 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 RemoteAccessView, type RemoteAccountView, type RemoteBrowserAuthPollRequest, type RemoteBrowserAuthPollResult, type RemoteBrowserAuthStartRequest, type RemoteBrowserAuthStartResult, type RemoteDoctorCheckView, type RemoteDoctorView, type RemoteLoginRequest, type RemoteRuntimeView, type RemoteServiceAction, type RemoteServiceActionResult, type RemoteServiceView, type RemoteSettingsUpdateRequest, type RemoteSettingsView, type RuntimeConfigUpdate, type SearchConfigUpdate, type SearchConfigView, type SearchProviderConfigView, type SearchProviderName, type SearchProviderSpecView, 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 SessionTypeDescribeParams, type SessionsListView, type UiChatRuntime, type UiNcpAgent, type UiNcpSessionListView, type UiNcpSessionMessagesView, type UiRemoteAccessHost, type UiServerEvent, type UiServerHandle, type UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createCustomProvider, createUiRouter, deleteCustomProvider, deleteSession, ensureUiBridgeSecret, executeConfigAction, getSessionHistory, getUiBridgeSecretPath, listSessions, loadConfigOrDefault, patchSession, readUiBridgeSecret, startUiServer, testProviderConnection, updateChannel, updateModel, updateProvider, updateRuntime, updateSearch, updateSecrets };
+export { type AgentBindingView, type AgentProfileView, type ApiError, type ApiResponse, type AppMetaView, type AuthEnabledUpdateRequest, type AuthLoginRequest, type AuthPasswordUpdateRequest, type AuthSetupRequest, type AuthStatusView, type BindingPeerView, type BochaFreshnessValue, type ChannelAuthPollRequest, type ChannelAuthPollResult, type ChannelAuthStartRequest, type ChannelAuthStartResult, type ChannelSpecView, type ChatCapabilitiesView, type ChatCommandOptionView, type ChatCommandView, type ChatCommandsView, type ChatRunListView, type ChatRunState, type ChatRunView, type ChatSessionTypeCtaView, 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 MarketplaceMcpContentView, type MarketplaceMcpDoctorResult, type MarketplaceMcpInstallKind, type MarketplaceMcpInstallRequest, type MarketplaceMcpInstallResult, type MarketplaceMcpInstallSpec, type MarketplaceMcpManageAction, type MarketplaceMcpManageRequest, type MarketplaceMcpManageResult, type MarketplaceMcpTemplateInput, 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 RemoteAccessView, type RemoteAccountView, type RemoteBrowserAuthPollRequest, type RemoteBrowserAuthPollResult, type RemoteBrowserAuthStartRequest, type RemoteBrowserAuthStartResult, type RemoteDoctorCheckView, type RemoteDoctorView, type RemoteLoginRequest, type RemoteRuntimeView, type RemoteServiceAction, type RemoteServiceActionResult, type RemoteServiceView, type RemoteSettingsUpdateRequest, type RemoteSettingsView, type RuntimeConfigUpdate, type SearchConfigUpdate, type SearchConfigView, type SearchProviderConfigView, type SearchProviderName, type SearchProviderSpecView, 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 SessionTypeDescribeParams, type SessionsListView, type UiChatRuntime, type UiNcpAgent, type UiNcpAttachmentUploadView, type UiNcpAttachmentView, type UiNcpSessionListView, type UiNcpSessionMessagesView, type UiNcpStoredAttachmentRecord, type UiRemoteAccessHost, type UiServerEvent, type UiServerHandle, type UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createCustomProvider, createUiRouter, deleteCustomProvider, deleteSession, ensureUiBridgeSecret, executeConfigAction, getSessionHistory, getUiBridgeSecretPath, listSessions, loadConfigOrDefault, patchSession, readUiBridgeSecret, startUiServer, testProviderConnection, updateChannel, updateModel, updateProvider, updateRuntime, updateSearch, updateSecrets };

package/dist/index.js

@@ -4,7 +4,7 @@ import { compress } from "hono/compress";
 import { serve } from "@hono/node-server";
 import { WebSocketServer, WebSocket } from "ws";
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
-import { readFile as readFile2, stat } from "fs/promises";
+import { readFile as readFile3, stat } from "fs/promises";
 import { join as join2 } from "path";
 
 // src/ui/auth.service.ts
@@ -836,6 +836,7 @@ var PREFERRED_PROVIDER_ORDER = [
   "anthropic",
   "gemini",
   "openrouter",
+  "dashscope-coding-plan",
   "dashscope",
   "deepseek",
   "minimax",
@@ -3612,6 +3613,87 @@ var CronRoutesController = class {
   };
 };
 
+// src/ui/router/ncp-attachment.controller.ts
+import { readFile as readFile2 } from "fs/promises";
+var ATTACHMENT_CONTENT_BASE_PATH = "/api/ncp/attachments/content";
+function buildAttachmentContentUrl(attachmentUri) {
+  const query = new URLSearchParams({ uri: attachmentUri });
+  return `${ATTACHMENT_CONTENT_BASE_PATH}?${query.toString()}`;
+}
+function encodeContentDispositionFileName(fileName) {
+  return encodeURIComponent(fileName).replace(/\*/g, "%2A");
+}
+function toAttachmentView(record) {
+  return {
+    id: record.id,
+    name: record.originalName,
+    mimeType: record.mimeType,
+    sizeBytes: record.sizeBytes,
+    attachmentUri: record.uri,
+    url: buildAttachmentContentUrl(record.uri)
+  };
+}
+var NcpAttachmentRoutesController = class {
+  constructor(options) {
+    this.options = options;
+  }
+  uploadAttachments = async (c) => {
+    const attachmentApi = this.options.ncpAgent?.attachmentApi;
+    if (!attachmentApi) {
+      return c.json(err("NOT_AVAILABLE", "ncp attachment api unavailable"), 503);
+    }
+    let formData;
+    try {
+      formData = await c.req.raw.formData();
+    } catch {
+      return c.json(err("INVALID_BODY", "invalid multipart body"), 400);
+    }
+    const files = Array.from(formData.values()).reduce((result, value) => {
+      if (typeof value !== "string") {
+        result.push(value);
+      }
+      return result;
+    }, []);
+    if (files.length === 0) {
+      return c.json(err("INVALID_BODY", "no files provided"), 400);
+    }
+    const attachments = [];
+    for (const file of files) {
+      const record = await attachmentApi.saveAttachment({
+        fileName: file.name,
+        mimeType: file.type || null,
+        bytes: new Uint8Array(await file.arrayBuffer())
+      });
+      attachments.push(toAttachmentView(record));
+    }
+    const payload = { attachments };
+    return c.json(ok(payload));
+  };
+  getAttachmentContent = async (c) => {
+    const attachmentApi = this.options.ncpAgent?.attachmentApi;
+    if (!attachmentApi) {
+      return c.json(err("NOT_AVAILABLE", "ncp attachment api unavailable"), 503);
+    }
+    const uri = c.req.query("uri")?.trim();
+    if (!uri) {
+      return c.json(err("INVALID_URI", "attachment uri is required"), 400);
+    }
+    const record = await attachmentApi.statAttachment(uri);
+    const contentPath = attachmentApi.resolveContentPath(uri);
+    if (!record || !contentPath) {
+      return c.json(err("NOT_FOUND", `attachment not found: ${uri}`), 404);
+    }
+    const body = await readFile2(contentPath);
+    return new Response(body, {
+      headers: {
+        "content-length": String(body.byteLength),
+        "content-type": record.mimeType || "application/octet-stream",
+        "content-disposition": `inline; filename*=UTF-8''${encodeContentDispositionFileName(record.originalName)}`
+      }
+    });
+  };
+};
+
 // src/ui/router/ncp-session.controller.ts
 function readPositiveInt(value) {
   if (typeof value !== "string") {
@@ -5388,7 +5470,7 @@ function registerSessionRoutes(app, sessionController) {
   app.put("/api/sessions/:key", sessionController.patchSession);
   app.delete("/api/sessions/:key", sessionController.deleteSession);
 }
-function registerNcpRoutes(app, options, ncpSessionController) {
+function registerNcpRoutes(app, options, ncpSessionController, ncpAttachmentController) {
   if (!options.ncpAgent) {
     return;
   }
@@ -5403,6 +5485,8 @@ function registerNcpRoutes(app, options, ncpSessionController) {
   app.put("/api/ncp/sessions/:sessionId", ncpSessionController.patchSession);
   app.get("/api/ncp/sessions/:sessionId/messages", ncpSessionController.listSessionMessages);
   app.delete("/api/ncp/sessions/:sessionId", ncpSessionController.deleteSession);
+  app.post("/api/ncp/attachments", ncpAttachmentController.uploadAttachments);
+  app.get("/api/ncp/attachments/content", ncpAttachmentController.getAttachmentContent);
 }
 function registerCronRoutes(app, cronController) {
   app.get("/api/cron", cronController.listJobs);
@@ -5434,6 +5518,7 @@ function createUiRouter(options) {
   const sessionController = new SessionRoutesController(options);
   const cronController = new CronRoutesController(options);
   const ncpSessionController = new NcpSessionRoutesController(options);
+  const ncpAttachmentController = new NcpAttachmentRoutesController(options);
   const remoteController = options.remoteAccess ? new RemoteRoutesController(options.remoteAccess) : null;
   const pluginMarketplaceController = new PluginMarketplaceController(options, marketplaceBaseUrl);
   const skillMarketplaceController = new SkillMarketplaceController(options, marketplaceBaseUrl);
@@ -5458,7 +5543,7 @@ function createUiRouter(options) {
   registerConfigRoutes(app, configController);
   registerChatRoutes(app, chatController);
   registerSessionRoutes(app, sessionController);
-  registerNcpRoutes(app, options, ncpSessionController);
+  registerNcpRoutes(app, options, ncpSessionController, ncpAttachmentController);
   registerCronRoutes(app, cronController);
   registerRemoteRoutes(app, remoteController);
   mountMarketplaceRoutes(app, {
@@ -5584,7 +5669,7 @@ function startUiServer(options) {
         join: join2,
         getContent: async (path) => {
           try {
-            return await readFile2(path);
+            return await readFile3(path);
           } catch {
             return null;
           }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/server",
-  "version": "0.10.55",
+  "version": "0.10.56",
   "private": false,
   "description": "Nextclaw UI/API server.",
   "type": "module",
@@ -19,11 +19,11 @@
     "hono": "^4.6.2",
     "ws": "^8.18.0",
     "@nextclaw/mcp": "0.1.50",
-    "@nextclaw/ncp": "0.3.2",
     "@nextclaw/ncp-http-agent-server": "0.3.2",
-    "@nextclaw/runtime": "0.2.15",
-    "@nextclaw/openclaw-compat": "0.3.31",
-    "@nextclaw/core": "0.11.1"
+    "@nextclaw/ncp": "0.3.2",
+    "@nextclaw/openclaw-compat": "0.3.32",
+    "@nextclaw/core": "0.11.1",
+    "@nextclaw/runtime": "0.2.15"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",