@clawchatsai/connector 0.0.63 → 0.0.65

package/dist/index.js

@@ -125,8 +125,40 @@ async function ensureNativeModules(ctx) {
         }
     }
 }
+const CLAWCHATS_MD_CONTENT = `# ClawChats — Inline File Delivery
+
+To deliver a file inline in this chat, run an exec that outputs a MEDIA: line:
+
+    MEDIA:/absolute/path/to/file
+
+**After creating any file** (via Write tool or exec), deliver it by running:
+
+    exec echo "MEDIA:/absolute/path/to/file"
+
+For files created during an exec command, you can inline it at the end of the same command:
+
+    exec python3 generate.py --output /tmp/result.png && echo "MEDIA:/tmp/result.png"
+
+Notes:
+- Works for images (png, jpg, gif, webp, svg, etc.), documents, markdown, code files, and more
+- Output each path once — duplicates are ignored automatically
+`;
 async function startClawChats(ctx, api, mediaStash) {
     _stopRequested = false;
+    // Bootstrap CLAWCHATS.md in the agent workspace so the agent always knows the MEDIA: protocol.
+    // Written once on plugin start; never overwrites an existing file (user may have customised it).
+    try {
+        const workspaceDir = path.join(ctx.stateDir, 'workspace');
+        const clawchatsDoc = path.join(workspaceDir, 'CLAWCHATS.md');
+        if (!fs.existsSync(clawchatsDoc)) {
+            fs.mkdirSync(workspaceDir, { recursive: true });
+            fs.writeFileSync(clawchatsDoc, CLAWCHATS_MD_CONTENT, { encoding: 'utf8' });
+            ctx.logger.info('[clawchats] wrote CLAWCHATS.md to workspace');
+        }
+    }
+    catch (e) {
+        ctx.logger.warn(`[clawchats] could not write CLAWCHATS.md: ${e.message}`);
+    }
     let config = loadConfig();
     if (!config) {
         ctx.logger.info('ClawChats not configured. Waiting for setup...');
@@ -356,8 +388,6 @@ async function stopClawChats(ctx) {
  * guard checks MediaPath/MediaPaths but not inline base64 attachments).
  * Injecting a minimal placeholder ensures the agent run proceeds.
  */
-// Track which ClawChats thread sessions have received the file-hint (once per session).
-const _hintedSessions = new Set();
 function normalizeGatewayPayload(raw) {
     try {
         const parsed = JSON.parse(raw);
@@ -379,15 +409,6 @@ function normalizeGatewayPayload(raw) {
                 parsed.params.message = '[Image]';
                 return JSON.stringify(parsed);
             }
-            // Hint injection: teach the agent to emit MEDIA:/path via exec after creating files.
-            // Injected once per ClawChats thread session (~15 tokens, invisible to user).
-            const sk = parsed.params.sessionKey || '';
-            if (sk.includes(':chat:') && !_hintedSessions.has(sk)) {
-                _hintedSessions.add(sk);
-                parsed.params.message += '\n[ClawChats: after creating or saving any file, run: exec echo "MEDIA:/absolute/path/to/file" — this delivers it inline to the chat]';
-                console.log(`[clawchats] hint-injected for session ${sk}`);
-                return JSON.stringify(parsed);
-            }
         }
     }
     catch {
@@ -1102,7 +1123,7 @@ const plugin = {
             if (!sessionKey)
                 return;
             const existing = mediaStash.get(sessionKey) ?? [];
-            mediaStash.set(sessionKey, [...existing, ...paths]);
+            mediaStash.set(sessionKey, [...new Set([...existing, ...paths])]);
             console.log(`[clawchats] media-capture: stashed ${paths.length} path(s) for ${sessionKey}:`, paths);
         }, { name: 'clawchats-media-capture', description: 'Captures MEDIA: paths from exec results for inline image rendering' });
         // Background service: signaling + gateway bridge + future WebRTC

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawchatsai/connector",
-  "version": "0.0.63",
+  "version": "0.0.65",
   "type": "module",
   "description": "ClawChats OpenClaw plugin — P2P tunnel + local API bridge",
   "main": "dist/index.js",