@otterware/openclaw-otter 0.1.1 → 0.1.2

package/files.js

@@ -0,0 +1,23 @@
+import { open, realpath } from "node:fs/promises";
+import path from "node:path";
+
+export const MAX_FILE_BYTES = 50 * 1024 * 1024;
+
+/** A file in the agent's workspace, whole: the gateway's own reader stops at images and small text. */
+export async function readWorkspaceFile(workspace, requested) {
+  const root = await realpath(workspace);
+  const file = await realpath(path.resolve(root, requested)).catch(() => {
+    throw new Error("file not found");
+  });
+  if (!file.startsWith(root + path.sep)) throw new Error("file is outside the agent's workspace");
+  const handle = await open(file, "r");
+  try {
+    const stat = await handle.stat();
+    if (!stat.isFile()) throw new Error("file not found");
+    if (stat.size > MAX_FILE_BYTES) throw new Error("file is too large (50 MB max)");
+    const data = await handle.readFile();
+    return { name: path.basename(file), size: data.length, content: data.toString("base64") };
+  } finally {
+    await handle.close();
+  }
+}

package/index.js

@@ -4,6 +4,9 @@ import {
   createChatChannelPlugin,
   defineChannelPluginEntry,
 } from "openclaw/plugin-sdk/channel-core";
+import { resolveAgentWorkspaceDir } from "openclaw/plugin-sdk/agent-runtime";
+import { resolveAgentIdFromSessionKey } from "openclaw/plugin-sdk/routing";
+import { readWorkspaceFile } from "./files.js";
 import { accountOf, inboxKey, OTTER_TARGET, pointerOf, tell } from "./otter.js";
 
 async function deliver(ctx, payload) {
@@ -59,4 +62,19 @@ export default defineChannelPluginEntry({
   name: "Otter",
   description: "Send what your agents want you to see to Otter.",
   plugin: otterChannel,
+  registerFull(api) {
+    // Otter's preview of a file an agent linked: PDFs and other files sessions.files.get won't send.
+    api.registerGatewayMethod(
+      "otter.files.get",
+      async ({ params, context }) => {
+        const { sessionKey, path } = params ?? {};
+        if (typeof sessionKey !== "string" || typeof path !== "string" || !path)
+          throw new Error("sessionKey and path are required");
+        const cfg = context?.getRuntimeConfig?.() ?? api.config;
+        const workspace = resolveAgentWorkspaceDir(cfg, resolveAgentIdFromSessionKey(sessionKey));
+        return { file: await readWorkspaceFile(workspace, path) };
+      },
+      { scope: "operator.read" },
+    );
+  },
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@otterware/openclaw-otter",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Otter as an OpenClaw channel: what your agents send you waits in Otter, and Otter tells your devices.",
   "license": "MIT",
   "repository": {
@@ -10,6 +10,7 @@
   },
   "files": [
     "index.js",
+    "files.js",
     "otter.js",
     "openclaw.plugin.json"
   ],