adp-openclaw 0.0.31 → 0.0.32

package/index.ts

@@ -1,7 +1,15 @@
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
 import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
-import { adpOpenclawPlugin } from "./src/channel.js";
+import { adpOpenclawPlugin, type AdpOpenclawChannelConfig } from "./src/channel.js";
 import { setAdpOpenclawRuntime } from "./src/runtime.js";
+import {
+  ADP_UPLOAD_TOOL_NAME,
+  ADP_UPLOAD_TOOL_SCHEMA,
+  parseAdpUploadToolParams,
+  uploadFilesToAdpEndpoint,
+  type AdpUploadToolResult,
+  type UploadedFileInfo,
+} from "./src/adp-upload-tool.js";
 
 // Export session history functions for external use
 export {
@@ -72,6 +80,10 @@ export {
   type MessageBlock,
 } from "./src/tool-result-message-blocks.js";
 
+// Helper to format tool result as JSON string
+const formatToolResultJson = (result: unknown): string => 
+  JSON.stringify(result, null, 2) ?? "upload failed";
+
 const plugin = {
   id: "adp-openclaw",
   name: "ADP OpenClaw",
@@ -80,6 +92,127 @@ const plugin = {
   register(api: OpenClawPluginApi) {
     // console.log("[adp-openclaw] register() called");
     setAdpOpenclawRuntime(api.runtime);
+    
+    // Register the ADP file upload tool
+    // This allows AI to send files to users via ADP storage
+    api.registerTool({
+      name: ADP_UPLOAD_TOOL_NAME,
+      description: 
+        "If you can see this tool description, you are connected to the ADP server. " +
+        "Use this tool to send 1-10 local files of any type (including images and documents) to the user. " +
+        "A successful call means the files were uploaded and download URLs are returned. " +
+        "Include these URLs in your response so the user can access the files. " +
+        "Parameters must be local filesystem paths only.",
+      parameters: ADP_UPLOAD_TOOL_SCHEMA,
+      async execute(toolCallId: string, params: unknown) {
+        // Get bot token from channel config
+        const getClientToken = (): string | undefined => {
+          try {
+            const cfg = api.runtime?.config?.loadConfig?.();
+            const channelCfg = cfg?.channels?.["adp-openclaw"] as AdpOpenclawChannelConfig | undefined;
+            return channelCfg?.clientToken?.trim() || process.env.ADP_OPENCLAW_CLIENT_TOKEN;
+          } catch {
+            return process.env.ADP_OPENCLAW_CLIENT_TOKEN;
+          }
+        };
+
+        // Parse and validate parameters
+        const parsed = parseAdpUploadToolParams(params);
+        if (!parsed.ok) {
+          const errorResult = {
+            ok: false,
+            error: formatToolResultJson(parsed.error),
+          };
+          api.logger.debug?.(`[${ADP_UPLOAD_TOOL_NAME}] validation failed toolCallId=${toolCallId} error=${errorResult.error}`);
+          return {
+            output: errorResult,
+            result: errorResult,
+            details: errorResult,
+            content: [{ type: "text", text: formatToolResultJson(parsed.error) }],
+            isError: true,
+          };
+        }
+
+        // Get bot token
+        const botToken = getClientToken();
+        if (!botToken) {
+          const errorResult = {
+            ok: false,
+            error: "missing bot token for file upload - please configure clientToken in adp-openclaw channel settings",
+          };
+          api.logger.debug?.(`[${ADP_UPLOAD_TOOL_NAME}] token missing toolCallId=${toolCallId} paths=${JSON.stringify(parsed.value.paths)}`);
+          return {
+            output: errorResult,
+            result: errorResult,
+            details: errorResult,
+            content: [{ type: "text", text: errorResult.error }],
+            isError: true,
+          };
+        }
+
+        // Execute upload
+        const uploadResult = await uploadFilesToAdpEndpoint(parsed.value.paths, {
+          botToken,
+          fileType: parsed.value.fileType,
+        });
+
+        if (!uploadResult.ok) {
+          const errorResult = {
+            ok: false,
+            error: formatToolResultJson(uploadResult.error),
+          };
+          api.logger.debug?.(`[${ADP_UPLOAD_TOOL_NAME}] upload failed toolCallId=${toolCallId} paths=${JSON.stringify(parsed.value.paths)} error=${errorResult.error}`);
+          return {
+            output: errorResult,
+            result: errorResult,
+            details: errorResult,
+            content: [{ type: "text", text: formatToolResultJson(uploadResult.error) }],
+            isError: true,
+          };
+        }
+
+        // Success - format result with download URLs
+        const successResult: AdpUploadToolResult = {
+          ok: true,
+          files: uploadResult.files,
+        };
+
+        api.logger.debug?.(`[${ADP_UPLOAD_TOOL_NAME}] upload success toolCallId=${toolCallId} count=${successResult.files?.length ?? 0} paths=${JSON.stringify(parsed.value.paths)}`);
+
+        // Build content with resource links and download URLs
+        const content: Array<{ type: string; uri?: string; name?: string; mimeType?: string; text?: string }> = [];
+        
+        // Add resource links for each file
+        for (const file of (successResult.files || [])) {
+          content.push({
+            type: "resource_link",
+            uri: file.uri,
+            name: file.name,
+            mimeType: file.mimeType,
+          });
+        }
+
+        // Add a text summary with download URLs for AI to include in response
+        const urlSummary = (successResult.files || [])
+          .map((f: UploadedFileInfo) => `- [${f.name}](${f.downloadUrl || f.uri})`)
+          .join("\n");
+        
+        content.push({
+          type: "text",
+          text: `Files uploaded successfully:\n${urlSummary}`,
+        });
+
+        return {
+          output: successResult,
+          result: successResult,
+          details: successResult,
+          content,
+          isError: false,
+        };
+      },
+    });
+
+    // Register the channel plugin
     api.registerChannel({ plugin: adpOpenclawPlugin });
   },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adp-openclaw",
-  "version": "0.0.31",
+  "version": "0.0.32",
   "description": "ADP-OpenClaw demo channel plugin (Go WebSocket backend)",
   "type": "module",
   "dependencies": {