kojee-mcp 0.7.5-staging.16 → 0.7.5-staging.18

package/dist/{chunk-LY4DBSBS.js → chunk-Q2UVK7VA.js}

@@ -22,6 +22,10 @@ import os from "os";
 import path from "path";
 
 // src/tool-registry.ts
+import { readFileSync, statSync } from "fs";
+import { basename } from "path";
+var UPLOAD_TOOL = "tandem_upload_attachment";
+var MAX_UPLOAD_FILE_BYTES = 25 * 1024 * 1024;
 var ToolRegistry = class {
   constructor(gateway) {
     this.gateway = gateway;
@@ -68,8 +72,87 @@ var ToolRegistry = class {
       }
       this.tools.set(tool.name, tool);
     }
+    this.augmentUploadTool();
     console.error(`[tools] Registered ${this.tools.size} tools from gateway`);
   }
+  /**
+   * Teach the gateway's `tandem_upload_attachment` tool about a `file_path` arg
+   * that THIS proxy resolves in-process (see {@link resolveUploadFilePath}): the
+   * model emits a local path, the proxy reads the bytes and forwards them as
+   * `data_base64`, so a multi-MB image never has to be generated into the model's
+   * tool call. Purely additive — the original `data_base64` shape still works. A
+   * no-op if the gateway doesn't expose the tool (older backend).
+   */
+  augmentUploadTool() {
+    const tool = this.tools.get(UPLOAD_TOOL);
+    if (!tool) return;
+    const schema = { ...tool.inputSchema ?? {} };
+    const properties = { ...schema.properties ?? {} };
+    if ("file_path" in properties) return;
+    properties.file_path = {
+      type: "string",
+      description: "Absolute path to a local image file. Your local kojee-mcp-server reads the bytes and uploads them for you (downscaled server-side), so the image is NEVER placed in your prompt/tool-call. Prefer this over data_base64 for photos. Provide file_path OR data_base64, not both; filename is derived from the path when omitted."
+    };
+    schema.properties = properties;
+    if (Array.isArray(schema.required)) {
+      schema.required = schema.required.filter(
+        (k) => k !== "data_base64" && k !== "filename"
+      );
+    }
+    const dependent = {
+      ...schema.dependentRequired ?? {},
+      data_base64: ["filename"]
+    };
+    schema.dependentRequired = dependent;
+    this.tools.set(UPLOAD_TOOL, { ...tool, inputSchema: schema });
+  }
+  /**
+   * Resolve a `tandem_upload_attachment` call that used `file_path`: read the file
+   * locally, base64-encode the RAW bytes (Buffer→base64 is byte-exact — no text
+   * round-trip, so no U+FFFD corruption), and rewrite the args to the `data_base64`
+   * shape the gateway expects. Returns the args to forward, or throws with a clear
+   * message the caller surfaces as an isError result.
+   */
+  resolveUploadFilePath(args) {
+    const filePath = args.file_path;
+    const hasFilePath = typeof filePath === "string" && filePath.length > 0;
+    const hasBase64 = typeof args.data_base64 === "string" && args.data_base64.length > 0;
+    const hasFilename = typeof args.filename === "string" && args.filename.trim().length > 0;
+    if (!hasFilePath) {
+      if (hasBase64 && !hasFilename) {
+        throw new Error("filename is required when uploading with data_base64");
+      }
+      return args;
+    }
+    if (hasBase64) {
+      throw new Error("provide file_path OR data_base64, not both");
+    }
+    let size;
+    try {
+      const st = statSync(filePath);
+      if (!st.isFile()) throw new Error("not a regular file");
+      size = st.size;
+    } catch (err) {
+      throw new Error(`cannot read file_path '${filePath}': ${err?.message ?? String(err)}`);
+    }
+    if (size > MAX_UPLOAD_FILE_BYTES) {
+      throw new Error(
+        `file_path is ${size} bytes; exceeds the ${MAX_UPLOAD_FILE_BYTES}-byte upload cap`
+      );
+    }
+    const buf = readFileSync(filePath);
+    if (buf.length > MAX_UPLOAD_FILE_BYTES) {
+      throw new Error(
+        `file_path is ${buf.length} bytes; exceeds the ${MAX_UPLOAD_FILE_BYTES}-byte upload cap`
+      );
+    }
+    const { file_path: _drop, ...rest } = args;
+    return {
+      ...rest,
+      data_base64: buf.toString("base64"),
+      filename: hasFilename ? args.filename : basename(filePath)
+    };
+  }
   /**
    * Return all registered tools for the MCP ListTools response — gateway tools
    * first (minus any a local tool shadows), then local tools.
@@ -114,9 +197,20 @@ var ToolRegistry = class {
         isError: true
       };
     }
+    let outgoing = args;
+    if (name === UPLOAD_TOOL) {
+      try {
+        outgoing = this.resolveUploadFilePath(args);
+      } catch (err) {
+        return {
+          content: [{ type: "text", text: err?.message ?? String(err) }],
+          isError: true
+        };
+      }
+    }
     return this.gateway.sendRpc("tools/call", {
       name,
-      arguments: args
+      arguments: outgoing
     });
   }
   /** Total number of registered tools (gateway + local, shadowed names once). */
@@ -296,7 +390,7 @@ async function startProxy(config) {
   console.error(`[kojee-mcp] Tandem memberships: ${tandemMembershipCount === -1 ? "unknown" : tandemMembershipCount}`);
   let server;
   const isHeadlessDaemon = !!process.env["KOJEE_HEADLESS"] || !!process.env["KOJEE_WEBHOOK_EXPECTED"];
-  const { selectDelivery } = await import("./registry-BP5V3W5Y.js");
+  const { selectDelivery } = await import("./registry-MCJAVXJW.js");
   const delivery = selectDelivery(adapter.runtime, {
     supportsChannels: adapter.supportsChannels,
     headless: isHeadlessDaemon,

package/dist/{chunk-XXHYGH7G.js → chunk-UGEBGCYU.js}

@@ -205,7 +205,7 @@ function buildStreamUrl(brokerUrl, sinceValue, seatName) {
   if (sinceValue !== null) params.set("since", sinceValue);
   if (seatName) params.set("seat_name", seatName);
   const qs = params.toString();
-  return `${brokerUrl}/api/v2/tandems/stream${qs ? "?" + qs : ""}`;
+  return `${brokerUrl}/api/v2/tandems/stream/${qs ? "?" + qs : ""}`;
 }
 async function openStream(opts, controller, sinceValue, dispatcher) {
   const url = buildStreamUrl(opts.brokerUrl, sinceValue, opts.seatName);

package/dist/cli.js

@@ -4,7 +4,7 @@ import {
 } from "./chunk-EIAUW6KO.js";
 import {
   startProxy
-} from "./chunk-LY4DBSBS.js";
+} from "./chunk-Q2UVK7VA.js";
 import "./chunk-CCVRXJJ2.js";
 import {
   pairedConfigPath
@@ -134,7 +134,7 @@ program.command("tail <path>").description("Stream a file's appends and follow (
   "--replay",
   "Replay the whole file from the start before following (default: follow from EOF, no replay)"
 ).action(async (filePath, opts) => {
-  const { runTail } = await import("./tail-stream-MODWTGVA.js");
+  const { runTail } = await import("./tail-stream-PQXEY3TI.js");
   try {
     await runTail(filePath, { wakeOnly: opts.wakeOnly === true, replay: opts.replay === true });
   } catch (err) {

package/dist/{event-stream-K6G7B2KY.js → event-stream-5ZEL7FXN.js}

@@ -12,7 +12,7 @@ import {
   startEventStream,
   statusReason,
   undiciFetch
-} from "./chunk-XXHYGH7G.js";
+} from "./chunk-UGEBGCYU.js";
 import "./chunk-Z5LPNJQ6.js";
 import "./chunk-MIEI4PLB.js";
 export {

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   listTandemIds,
   startProxy
-} from "./chunk-LY4DBSBS.js";
+} from "./chunk-Q2UVK7VA.js";
 import "./chunk-CCVRXJJ2.js";
 import "./chunk-PKELUA3T.js";
 import "./chunk-Z5LPNJQ6.js";

package/dist/lib.d.ts

@@ -521,6 +521,23 @@ declare class ToolRegistry {
      * Fetch all tools with full schemas from the gateway in a single RPC call.
      */
     discoverTools(): Promise<void>;
+    /**
+     * Teach the gateway's `tandem_upload_attachment` tool about a `file_path` arg
+     * that THIS proxy resolves in-process (see {@link resolveUploadFilePath}): the
+     * model emits a local path, the proxy reads the bytes and forwards them as
+     * `data_base64`, so a multi-MB image never has to be generated into the model's
+     * tool call. Purely additive — the original `data_base64` shape still works. A
+     * no-op if the gateway doesn't expose the tool (older backend).
+     */
+    private augmentUploadTool;
+    /**
+     * Resolve a `tandem_upload_attachment` call that used `file_path`: read the file
+     * locally, base64-encode the RAW bytes (Buffer→base64 is byte-exact — no text
+     * round-trip, so no U+FFFD corruption), and rewrite the args to the `data_base64`
+     * shape the gateway expects. Returns the args to forward, or throws with a clear
+     * message the caller surfaces as an isError result.
+     */
+    private resolveUploadFilePath;
     /**
      * Return all registered tools for the MCP ListTools response — gateway tools
      * first (minus any a local tool shadows), then local tools.

package/dist/lib.js

@@ -2,7 +2,7 @@ import {
   normalizeBackendEvent,
   sanitizeDisplayname,
   startEventStream
-} from "./chunk-XXHYGH7G.js";
+} from "./chunk-UGEBGCYU.js";
 import {
   resubscribeMemberships
 } from "./chunk-OT2GILXC.js";

package/dist/{registry-BP5V3W5Y.js → registry-MCJAVXJW.js}

@@ -125,7 +125,7 @@ function createClaudeCodeDelivery() {
       const { resubscribeMemberships } = await import("./resubscribe-G5OGDZJD.js");
       const { resolveWebhookConfig } = await import("./webhook-config-O4WMQ532.js");
       const { createWebhookSink } = await import("./webhook-sink-N6AUTFL3.js");
-      const { startEventStream } = await import("./event-stream-K6G7B2KY.js");
+      const { startEventStream } = await import("./event-stream-5ZEL7FXN.js");
       const { createMcpServer } = await import("./server-VM3ZIGSZ.js");
       const { deriveDiscoveryKey } = await import("./ancestry-A2F5KQ6A.js");
       const { resolveSharedSessionId } = await import("./cc-session-id-5HHQJ7VC.js");
@@ -325,7 +325,7 @@ function createWebhookDelivery(name, pendingLedger) {
       const { resolveWebhookConfig } = await import("./webhook-config-O4WMQ532.js");
       const { createWebhookSink } = await import("./webhook-sink-N6AUTFL3.js");
       const { resubscribeMemberships } = await import("./resubscribe-G5OGDZJD.js");
-      const { startEventStream } = await import("./event-stream-K6G7B2KY.js");
+      const { startEventStream } = await import("./event-stream-5ZEL7FXN.js");
       const { createMcpServer } = await import("./server-VM3ZIGSZ.js");
       sweepStaleEventLogs();
       eventLog = startEventLog({
@@ -521,7 +521,7 @@ function createOpenclawDelivery(deps = {}) {
     async start(ctx) {
       const { startEventLog, sweepStaleEventLogs } = await import("./event-log-M22X3FAI.js");
       const { resubscribeMemberships } = await import("./resubscribe-G5OGDZJD.js");
-      const { startEventStream } = await import("./event-stream-K6G7B2KY.js");
+      const { startEventStream } = await import("./event-stream-5ZEL7FXN.js");
       const { createMcpServer } = await import("./server-VM3ZIGSZ.js");
       sweepStaleEventLogs();
       eventLog = startEventLog({

package/dist/{tail-stream-MODWTGVA.js → tail-stream-PQXEY3TI.js}

@@ -9,7 +9,7 @@ import {
   LOG_HEARTBEAT_INTERVAL_MS,
   UNARMED_FALLBACK_MS,
   createAdaptiveWatchdog
-} from "./chunk-XXHYGH7G.js";
+} from "./chunk-UGEBGCYU.js";
 import "./chunk-Z5LPNJQ6.js";
 import "./chunk-MIEI4PLB.js";
 import "./chunk-U5HHHRXA.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kojee-mcp",
-  "version": "0.7.5-staging.16",
+  "version": "0.7.5-staging.18",
   "type": "module",
   "main": "dist/index.js",
   "exports": {