@nextclaw/ncp-react 0.3.4 → 0.3.6

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { NcpAgentConversationSnapshot, NcpMessage, NcpRequestEnvelope, NcpAgentClientEndpoint } from '@nextclaw/ncp';
+import { NcpAgentConversationSnapshot, NcpMessage, NcpRequestEnvelope, NcpAgentClientEndpoint, NcpMessagePart } from '@nextclaw/ncp';
 
 type NcpAgentSendInput = string | NcpRequestEnvelope;
 type UseNcpAgentResult = {
@@ -34,13 +34,17 @@ declare function useNcpAgent(sessionId: string, client: NcpAgentClientEndpoint):
 
 declare const DEFAULT_NCP_IMAGE_ATTACHMENT_ACCEPT = "image/png,image/jpeg,image/webp,image/gif";
 declare const DEFAULT_NCP_IMAGE_ATTACHMENT_MIME_TYPES: readonly ["image/png", "image/jpeg", "image/webp", "image/gif"];
+declare const DEFAULT_NCP_ATTACHMENT_MAX_BYTES: number;
 declare const DEFAULT_NCP_IMAGE_ATTACHMENT_MAX_BYTES: number;
+declare const DEFAULT_NCP_FALLBACK_ATTACHMENT_MIME_TYPE = "application/octet-stream";
 type NcpDraftAttachment = {
     id: string;
     name: string;
     mimeType: string;
-    contentBase64: string;
     sizeBytes: number;
+    attachmentUri?: string;
+    url?: string;
+    contentBase64?: string;
 };
 type NcpRejectedAttachment = {
     fileName: string;
@@ -52,6 +56,9 @@ type ReadNcpDraftAttachmentsOptions = {
     acceptedMimeTypes?: readonly string[];
     maxBytes?: number;
 };
+type UploadNcpDraftAttachmentsOptions = ReadNcpDraftAttachmentsOptions & {
+    uploadBatch: (files: File[]) => Promise<NcpDraftAttachment[]>;
+};
 type ReadNcpDraftAttachmentsResult = {
     attachments: NcpDraftAttachment[];
     rejected: NcpRejectedAttachment[];
@@ -61,10 +68,12 @@ declare function buildNcpRequestEnvelope(params: {
     sessionId: string;
     text?: string;
     attachments?: readonly NcpDraftAttachment[];
+    parts?: readonly NcpMessagePart[];
     metadata?: Record<string, unknown>;
     messageId?: string;
     timestamp?: string;
 }): NcpRequestEnvelope | null;
 declare function readFilesAsNcpDraftAttachments(files: Iterable<File>, options?: ReadNcpDraftAttachmentsOptions): Promise<ReadNcpDraftAttachmentsResult>;
+declare function uploadFilesAsNcpDraftAttachments(files: Iterable<File>, options: UploadNcpDraftAttachmentsOptions): Promise<ReadNcpDraftAttachmentsResult>;
 
-export { DEFAULT_NCP_IMAGE_ATTACHMENT_ACCEPT, DEFAULT_NCP_IMAGE_ATTACHMENT_MAX_BYTES, DEFAULT_NCP_IMAGE_ATTACHMENT_MIME_TYPES, type NcpConversationSeed, type NcpConversationSeedLoader, type NcpDraftAttachment, type NcpRejectedAttachment, type ReadNcpDraftAttachmentsOptions, type ReadNcpDraftAttachmentsResult, type UseHydratedNcpAgentOptions, type UseHydratedNcpAgentResult, type UseNcpAgentResult, buildNcpImageAttachmentDataUrl, buildNcpRequestEnvelope, readFilesAsNcpDraftAttachments, useHydratedNcpAgent, useNcpAgent };
+export { DEFAULT_NCP_ATTACHMENT_MAX_BYTES, DEFAULT_NCP_FALLBACK_ATTACHMENT_MIME_TYPE, DEFAULT_NCP_IMAGE_ATTACHMENT_ACCEPT, DEFAULT_NCP_IMAGE_ATTACHMENT_MAX_BYTES, DEFAULT_NCP_IMAGE_ATTACHMENT_MIME_TYPES, type NcpConversationSeed, type NcpConversationSeedLoader, type NcpDraftAttachment, type NcpRejectedAttachment, type ReadNcpDraftAttachmentsOptions, type ReadNcpDraftAttachmentsResult, type UploadNcpDraftAttachmentsOptions, type UseHydratedNcpAgentOptions, type UseHydratedNcpAgentResult, type UseNcpAgentResult, buildNcpImageAttachmentDataUrl, buildNcpRequestEnvelope, readFilesAsNcpDraftAttachments, uploadFilesAsNcpDraftAttachments, useHydratedNcpAgent, useNcpAgent };

package/dist/index.js

@@ -233,7 +233,9 @@ var DEFAULT_NCP_IMAGE_ATTACHMENT_MIME_TYPES = [
   "image/webp",
   "image/gif"
 ];
-var DEFAULT_NCP_IMAGE_ATTACHMENT_MAX_BYTES = 10 * 1024 * 1024;
+var DEFAULT_NCP_ATTACHMENT_MAX_BYTES = 10 * 1024 * 1024;
+var DEFAULT_NCP_IMAGE_ATTACHMENT_MAX_BYTES = DEFAULT_NCP_ATTACHMENT_MAX_BYTES;
+var DEFAULT_NCP_FALLBACK_ATTACHMENT_MIME_TYPE = "application/octet-stream";
 function createAttachmentId() {
   return `ncp-file-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
 }
@@ -255,19 +257,57 @@ function toBase64Content(dataUrl) {
   const commaIndex = dataUrl.indexOf(",");
   return commaIndex >= 0 ? dataUrl.slice(commaIndex + 1) : dataUrl;
 }
+function normalizeAttachmentMimeType(file) {
+  const mimeType = file.type.trim().toLowerCase();
+  return mimeType.length > 0 ? mimeType : DEFAULT_NCP_FALLBACK_ATTACHMENT_MIME_TYPE;
+}
+function validateAttachmentFile(file, options) {
+  const acceptedMimeTypes = options.acceptedMimeTypes && options.acceptedMimeTypes.length > 0 ? new Set(options.acceptedMimeTypes.map((mimeType2) => mimeType2.trim().toLowerCase())) : null;
+  const maxBytes = options.maxBytes ?? DEFAULT_NCP_ATTACHMENT_MAX_BYTES;
+  const mimeType = normalizeAttachmentMimeType(file);
+  if (acceptedMimeTypes && !acceptedMimeTypes.has(mimeType)) {
+    return {
+      ok: false,
+      rejected: {
+        fileName: file.name,
+        mimeType,
+        sizeBytes: file.size,
+        reason: "unsupported-type"
+      }
+    };
+  }
+  if (file.size > maxBytes) {
+    return {
+      ok: false,
+      rejected: {
+        fileName: file.name,
+        mimeType,
+        sizeBytes: file.size,
+        reason: "too-large"
+      }
+    };
+  }
+  return { ok: true, mimeType };
+}
 function buildNcpImageAttachmentDataUrl(attachment) {
+  if (attachment.url?.trim()) {
+    return attachment.url.trim();
+  }
+  if (!attachment.contentBase64?.trim()) {
+    throw new Error(`Attachment ${attachment.name} does not have image content.`);
+  }
   return `data:${attachment.mimeType};base64,${attachment.contentBase64}`;
 }
 function buildNcpRequestEnvelope(params) {
-  const trimmedText = params.text?.trim() ?? "";
-  const attachments = params.attachments ?? [];
-  const parts = [
-    ...trimmedText ? [{ type: "text", text: trimmedText }] : [],
-    ...attachments.map((attachment) => ({
+  const parts = params.parts && params.parts.length > 0 ? params.parts.map((part) => structuredClone(part)) : [
+    ...params.text?.trim() ?? "" ? [{ type: "text", text: params.text.trim() }] : [],
+    ...(params.attachments ?? []).map((attachment) => ({
       type: "file",
       name: attachment.name,
       mimeType: attachment.mimeType,
-      contentBase64: attachment.contentBase64,
+      ...attachment.attachmentUri?.trim() ? { attachmentUri: attachment.attachmentUri.trim() } : {},
+      ...attachment.url?.trim() ? { url: attachment.url.trim() } : {},
+      ...attachment.contentBase64?.trim() ? { contentBase64: attachment.contentBase64.trim() } : {},
       sizeBytes: attachment.sizeBytes
     }))
   ];
@@ -291,30 +331,12 @@ function buildNcpRequestEnvelope(params) {
   };
 }
 async function readFilesAsNcpDraftAttachments(files, options = {}) {
-  const acceptedMimeTypes = new Set(
-    options.acceptedMimeTypes ?? DEFAULT_NCP_IMAGE_ATTACHMENT_MIME_TYPES
-  );
-  const maxBytes = options.maxBytes ?? DEFAULT_NCP_IMAGE_ATTACHMENT_MAX_BYTES;
   const attachments = [];
   const rejected = [];
   for (const file of files) {
-    const mimeType = file.type.trim().toLowerCase();
-    if (!acceptedMimeTypes.has(mimeType)) {
-      rejected.push({
-        fileName: file.name,
-        mimeType,
-        sizeBytes: file.size,
-        reason: "unsupported-type"
-      });
-      continue;
-    }
-    if (file.size > maxBytes) {
-      rejected.push({
-        fileName: file.name,
-        mimeType,
-        sizeBytes: file.size,
-        reason: "too-large"
-      });
+    const validation = validateAttachmentFile(file, options);
+    if (!validation.ok) {
+      rejected.push(validation.rejected);
       continue;
     }
     try {
@@ -322,14 +344,14 @@ async function readFilesAsNcpDraftAttachments(files, options = {}) {
       attachments.push({
         id: createAttachmentId(),
         name: file.name,
-        mimeType,
+        mimeType: validation.mimeType,
         contentBase64: toBase64Content(dataUrl),
         sizeBytes: file.size
       });
     } catch {
       rejected.push({
         fileName: file.name,
-        mimeType,
+        mimeType: validation.mimeType,
         sizeBytes: file.size,
         reason: "read-failed"
       });
@@ -337,13 +359,51 @@ async function readFilesAsNcpDraftAttachments(files, options = {}) {
   }
   return { attachments, rejected };
 }
+async function uploadFilesAsNcpDraftAttachments(files, options) {
+  const validFiles = [];
+  const rejected = [];
+  for (const file of files) {
+    const validation = validateAttachmentFile(file, options);
+    if (!validation.ok) {
+      rejected.push(validation.rejected);
+      continue;
+    }
+    validFiles.push(file);
+  }
+  if (validFiles.length === 0) {
+    return { attachments: [], rejected };
+  }
+  try {
+    const attachments = await options.uploadBatch(validFiles);
+    return {
+      attachments,
+      rejected
+    };
+  } catch {
+    rejected.push(
+      ...validFiles.map((file) => ({
+        fileName: file.name,
+        mimeType: normalizeAttachmentMimeType(file),
+        sizeBytes: file.size,
+        reason: "read-failed"
+      }))
+    );
+    return {
+      attachments: [],
+      rejected
+    };
+  }
+}
 export {
+  DEFAULT_NCP_ATTACHMENT_MAX_BYTES,
+  DEFAULT_NCP_FALLBACK_ATTACHMENT_MIME_TYPE,
   DEFAULT_NCP_IMAGE_ATTACHMENT_ACCEPT,
   DEFAULT_NCP_IMAGE_ATTACHMENT_MAX_BYTES,
   DEFAULT_NCP_IMAGE_ATTACHMENT_MIME_TYPES,
   buildNcpImageAttachmentDataUrl,
   buildNcpRequestEnvelope,
   readFilesAsNcpDraftAttachments,
+  uploadFilesAsNcpDraftAttachments,
   useHydratedNcpAgent,
   useNcpAgent
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/ncp-react",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "private": false,
   "description": "React bindings for building NCP-based agent applications.",
   "type": "module",
@@ -15,8 +15,8 @@
     "dist"
   ],
   "dependencies": {
-    "@nextclaw/ncp": "0.3.2",
-    "@nextclaw/ncp-toolkit": "0.4.2"
+    "@nextclaw/ncp-toolkit": "0.4.3",
+    "@nextclaw/ncp": "0.3.3"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"