@agentrux/agentrux-openclaw-plugin 0.3.2 → 0.3.4

package/README.md

@@ -2,12 +2,15 @@
 
 Connect your OpenClaw agent to other agents via AgenTrux — authenticated Pub/Sub for autonomous agents.
 
-**v0.3.1**: Now supports **Ingress mode** — external clients can send commands to OpenClaw via AgenTrux Topics and receive LLM-processed results back.
+**v0.3.3**: Ingress mode with image attachments, auto topic resolution for uploads, SSE/webhook dual support.
 
 ## Install
 
+> **Important:** `openclaw.json` に plugin config を設定してからインストールしてください。
+> config 未設定だと OpenClaw CLI がロードエラーで停止します。
+
 ```bash
-openclaw plugins install @agentrux/agentrux-openclaw-plugin
+openclaw plugins install @agentrux/agentrux-openclaw-plugin@0.3.3
 ```
 
 ## Quick Start

package/dist/dispatcher.js

@@ -197,8 +197,12 @@ class Dispatcher {
                 message: wrappedMessage,
                 idempotencyKey,
                 timeoutMs: this.config.subagentTimeoutMs,
+                extraSystemPrompt: `AgenTrux context: commandTopicId=${this.config.commandTopicId} ` +
+                    `resultTopicId=${this.config.resultTopicId}. ` +
+                    `Use resultTopicId as topic_id for agentrux_upload and agentrux_publish.`,
             });
             const responseText = dispatchResult.responseText || "";
+            const attachments = dispatchResult.attachments || [];
             // Add to outbox (waterline is NOT advanced here — outbox flush owns that)
             (0, outbox_1.addToOutbox)({
                 eventId,
@@ -208,6 +212,7 @@ class Dispatcher {
                     message: (0, sanitize_1.sanitizeResponse)(responseText || "No response from agent"),
                     status: dispatchResult.status === "ok" ? "completed" : "failed",
                     conversationKey,
+                    ...(attachments.length > 0 ? { attachments } : {}),
                 },
             });
             // Record processed event AFTER durable outbox write

package/dist/http-client.js

@@ -173,6 +173,7 @@ async function uploadFile(creds, topicId, filePath, contentType) {
     const info = await authRequest(creds, "POST", `/topics/${topicId}/payloads`, {
         content_type: contentType,
         filename,
+        size: data.length,
     });
     // 2. Upload file to presigned URL
     const uploadUrl = new URL(info.upload_url);

package/dist/index.d.ts

@@ -12,4 +12,10 @@
  *
  * Credentials: ~/.agentrux/credentials.json (0600)
  */
+export declare function consumeAttachments(sessionKey: string): Array<{
+    download_url?: string;
+    content_type: string;
+    name: string;
+    object_id: string;
+}>;
 export default function (api: any): void;

package/dist/index.js

@@ -13,7 +13,41 @@
  *
  * Credentials: ~/.agentrux/credentials.json (0600)
  */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.consumeAttachments = consumeAttachments;
 exports.default = default_1;
 const credentials_1 = require("./credentials");
 const http_client_1 = require("./http-client");
@@ -25,6 +59,15 @@ const poller_1 = require("./poller");
 const sse_listener_1 = require("./sse-listener");
 // Module-level state for tools (shared across tool calls)
 let credentials = null;
+// Attachment registry: sessionKey → attachments (consumed by dispatcher after subagent.run)
+const pendingAttachments = new Map();
+// Current session key for the active subagent run (set by dispatch endpoint)
+let activeSessionKey = null;
+function consumeAttachments(sessionKey) {
+    const attachments = pendingAttachments.get(sessionKey) || [];
+    pendingAttachments.delete(sessionKey);
+    return attachments;
+}
 function getCredentials() {
     if (!credentials) {
         credentials = (0, credentials_1.loadCredentials)();
@@ -47,6 +90,10 @@ function default_1(api) {
         warn: (...a) => (rawLogger.warn || console.warn)(...a),
         error: (...a) => (rawLogger.error || console.error)(...a),
     };
+    // Resolve plugin config early so tools can access topic IDs
+    const pluginConfig = api.pluginConfig
+        || api.config?.plugins?.entries?.["agentrux-openclaw-plugin"]?.config
+        || {};
     // =======================================================================
     // TOOLS (available to LLM in all modes)
     // =======================================================================
@@ -197,19 +244,35 @@ function default_1(api) {
     api.registerTool({
         name: "agentrux_upload",
         description: "Upload a local file to AgenTrux and get a download URL. " +
-            "Use this to attach screenshots, logs, or other files to your response.",
+            "Use this to attach screenshots, logs, or other files to your response. " +
+            "The topic is automatically resolved from plugin config.",
         parameters: {
             type: "object",
             properties: {
-                topic_id: { type: "string", description: "Topic UUID to attach the file to" },
                 file_path: { type: "string", description: "Absolute path to the local file" },
                 content_type: { type: "string", description: "MIME type (e.g. image/png, text/plain)" },
             },
-            required: ["topic_id", "file_path", "content_type"],
+            required: ["file_path", "content_type"],
         },
         async execute(_id, params) {
             const creds = getCredentials();
-            const result = await (0, http_client_1.uploadFile)(creds, params.topic_id, params.file_path, params.content_type);
+            // Auto-resolve topic from plugin config (resultTopicId or commandTopicId)
+            const uploadTopicId = pluginConfig.resultTopicId || pluginConfig.commandTopicId || "";
+            if (!uploadTopicId) {
+                return { content: [{ type: "text", text: "Upload failed: no topic configured for uploads." }] };
+            }
+            const pth = await Promise.resolve().then(() => __importStar(require("path")));
+            const result = await (0, http_client_1.uploadFile)(creds, uploadTopicId, params.file_path, params.content_type);
+            // Register attachment for the active subagent run
+            if (activeSessionKey) {
+                const list = pendingAttachments.get(activeSessionKey) || [];
+                list.push({
+                    object_id: result.object_id,
+                    content_type: params.content_type,
+                    name: pth.basename(params.file_path),
+                });
+                pendingAttachments.set(activeSessionKey, list);
+            }
             return {
                 content: [{
                         type: "text",
@@ -229,11 +292,6 @@ function default_1(api) {
     globalThis.__agentruxIngressStarted = true;
     // Clear token cache on startup to pick up latest grant scopes
     (0, http_client_1.invalidateToken)();
-    // pluginConfig may be undefined if OpenClaw doesn't resolve it due to id mismatch
-    // Fallback: read from api.config (full OpenClaw config)
-    const pluginConfig = api.pluginConfig
-        || api.config?.plugins?.entries?.["agentrux-openclaw-plugin"]?.config
-        || {};
     const commandTopicId = pluginConfig.commandTopicId;
     const resultTopicId = pluginConfig.resultTopicId;
     const webhookSecret = pluginConfig.webhookSecret;
@@ -279,6 +337,8 @@ function default_1(api) {
             });
             const params = JSON.parse(Buffer.concat(chunks).toString());
             try {
+                // Track active session for attachment registry
+                activeSessionKey = params.sessionKey;
                 // OpenClaw 2026.3.24+: provider/model override is not authorized
                 // for plugin subagent runs. The agent's configured model is used.
                 const { runId } = await api.runtime.subagent.run({
@@ -286,6 +346,7 @@ function default_1(api) {
                     message: params.message,
                     idempotencyKey: params.idempotencyKey,
                     deliver: false,
+                    ...(params.extraSystemPrompt ? { extraSystemPrompt: params.extraSystemPrompt } : {}),
                 });
                 const waitResult = await api.runtime.subagent.waitForRun({
                     runId,
@@ -304,11 +365,17 @@ function default_1(api) {
                         }
                     }
                 }
+                // Collect attachments uploaded during this run
+                const attachments = consumeAttachments(params.sessionKey);
+                activeSessionKey = null;
                 res.statusCode = 200;
                 res.setHeader("Content-Type", "application/json");
-                res.end(JSON.stringify({ responseText, status: waitResult.status }));
+                res.end(JSON.stringify({ responseText, status: waitResult.status, attachments }));
             }
             catch (e) {
+                if (params.sessionKey)
+                    consumeAttachments(params.sessionKey);
+                activeSessionKey = null;
                 res.statusCode = 500;
                 res.end(JSON.stringify({ responseText: "", status: "error", error: e.message }));
             }

package/dist/outbox.d.ts

@@ -14,8 +14,9 @@ export interface OutboxEntry {
         status: string;
         conversationKey?: string;
         attachments?: Array<{
-            url: string;
-            type: string;
+            object_id: string;
+            content_type: string;
+            name: string;
         }>;
     };
     createdAt: string;

package/dist/outbox.js

@@ -105,12 +105,16 @@ async function flushOutbox(creds, resultTopicId, logger) {
         if (entry.status !== "pending_publish")
             continue;
         try {
-            await (0, http_client_1.publishEvent)(creds, resultTopicId, "openclaw.response", {
+            const payload = {
                 request_id: entry.requestId,
                 conversation_key: entry.result.conversationKey,
                 status: entry.result.status,
                 message: entry.result.message,
-            });
+            };
+            if (entry.result.attachments?.length) {
+                payload.attachments = entry.result.attachments;
+            }
+            await (0, http_client_1.publishEvent)(creds, resultTopicId, "openclaw.response", payload);
             entry.status = "published";
             store.published.push({ ...entry });
             finalized.push(entry.sequenceNo);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentrux/agentrux-openclaw-plugin",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "OpenClaw plugin for AgenTrux — Agent-to-Agent authenticated Pub/Sub",
   "keywords": [
     "openclaw",