kojee-mcp 0.7.5-staging.2 → 0.7.5-staging.21

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { G as GatewayClient, P as ProxyConfig } from './gateway-client-CbM2OC_w.js';
+import { G as GatewayClient, P as ProxyConfig } from './gateway-client-CLmQghON.js';
 import 'jose';
 
 /**

package/dist/index.js

@@ -1,20 +1,19 @@
 import {
   listTandemIds,
   startProxy
-} from "./chunk-ZSHCHOPL.js";
-import "./chunk-TCWIXG5C.js";
-import "./chunk-247WFMCJ.js";
+} from "./chunk-676WQSWZ.js";
+import "./chunk-CCVRXJJ2.js";
+import "./chunk-AGZ7ZGLY.js";
 import "./chunk-Z5LPNJQ6.js";
 import "./chunk-I67C2HYA.js";
 import "./chunk-MIEI4PLB.js";
 import "./chunk-6G6YYST6.js";
 import "./chunk-U5HHHRXA.js";
-import "./chunk-A4IOKD4Z.js";
-import "./chunk-5DHIUN73.js";
-import "./chunk-FJUAMJHU.js";
+import "./chunk-QYZP6QT2.js";
+import "./chunk-6NPMVZD7.js";
 import "./chunk-PPTKGWFF.js";
 import "./chunk-XJEBJIQE.js";
-import "./chunk-KNEJTD6G.js";
+import "./chunk-SZLNNMIZ.js";
 export {
   listTandemIds,
   startProxy

package/dist/{install-JQNDGAAQ.js → install-GJVZEWLI.js}

@@ -1,10 +1,10 @@
-import {
-  buildHookCommand,
-  isKojeeHookCommand
-} from "./chunk-TMCNB4JH.js";
 import {
   wrapNpxLauncher
 } from "./chunk-D6JKFJ6A.js";
+import {
+  buildHookCommand,
+  isKojeeHookCommand
+} from "./chunk-AXBJQJKA.js";
 import {
   secureFile
 } from "./chunk-U5HHHRXA.js";
@@ -77,7 +77,7 @@ function installHookEntry(cfg, event, command) {
 function uninstallHookEntries(cfg) {
   let removed = false;
   if (!cfg.hooks) return false;
-  for (const event of ["Stop", "UserPromptSubmit"]) {
+  for (const event of ["Stop", "UserPromptSubmit", "SessionStart"]) {
     const arr = cfg.hooks[event];
     if (!arr) continue;
     const before = arr.length;
@@ -93,7 +93,8 @@ function installHooks(opts = {}) {
   const cfg = readConfig(p);
   const stop = installHookEntry(cfg, "Stop", buildHookCommand("stop"));
   const ups = installHookEntry(cfg, "UserPromptSubmit", buildHookCommand("user-prompt-submit"));
-  if (stop !== "already-installed" || ups !== "already-installed") {
+  const sessionStart = installHookEntry(cfg, "SessionStart", buildHookCommand("session-start"));
+  if (stop !== "already-installed" || ups !== "already-installed" || sessionStart !== "already-installed") {
     writeConfig(p, cfg);
   } else {
     const newContent = JSON.stringify(cfg, null, 2);
@@ -106,7 +107,7 @@ function installHooks(opts = {}) {
       writeConfig(p, cfg);
     }
   }
-  return { stop, ups };
+  return { stop, ups, sessionStart };
 }
 function uninstallHooks(opts = {}) {
   const p = opts.hooksPath ?? (opts.configPath ? deriveHooksPath(opts.configPath) : defaultHooksPath());

package/dist/lib.d.ts

@@ -1,5 +1,5 @@
 import { KeyLike, JWK } from 'jose';
-import { L as LoadedKeyPair, K as KeystoreData, G as GatewayClient, M as McpToolDefinition, T as ToolCallResult, P as ProxyConfig } from './gateway-client-CbM2OC_w.js';
+import { L as LoadedKeyPair, K as KeystoreData, G as GatewayClient, M as McpToolDefinition, T as ToolCallResult, P as ProxyConfig } from './gateway-client-CLmQghON.js';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 
 /**
@@ -39,6 +39,7 @@ interface TandemEvent {
     severity?: string;
     wake?: boolean;
     wake_reason?: string;
+    edited_at?: string | null;
 }
 
 /**
@@ -261,6 +262,17 @@ interface EventStreamOptions {
     gateway: GatewayClient;
     adapter: HarnessAdapter;
     server: Server;
+    /**
+     * This connection's STABLE per-seat identity (SEAT-INVITE #226 per-seat
+     * routing). When set, the stream opens with `?seat_name=<value>` so the
+     * backend subscribes this seat's own `seat:{agent}:{seat_name}` channel and
+     * scopes the invite catch-up to it — so a per-seat invite wakes ONLY this
+     * seat, not every seat of a shared agent_id (the Clauron dev fleet all share
+     * one agent). It MUST be the exact `tandem_join` seat_name (e.g. "Backend-Dev",
+     * NOT the hyphen-form `KOJEE_INSTANCE`); the backend normalizes both sides
+     * identically. Unset ⇒ no `?seat_name=` (legacy agent-wide invite wake).
+     */
+    seatName?: string;
     queue?: EventQueue;
     eventLog?: EventLog;
     /**
@@ -509,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-CUOJHP2S.js";
+} from "./chunk-UGEBGCYU.js";
 import {
   resubscribeMemberships
 } from "./chunk-OT2GILXC.js";
@@ -13,7 +13,7 @@ import {
 import {
   GatewayClient,
   applyStableSessionId
-} from "./chunk-247WFMCJ.js";
+} from "./chunk-AGZ7ZGLY.js";
 import {
   deriveStableSessionId
 } from "./chunk-Z5LPNJQ6.js";
@@ -32,7 +32,7 @@ import {
 } from "./chunk-6G6YYST6.js";
 import "./chunk-U5HHHRXA.js";
 import "./chunk-PPTKGWFF.js";
-import "./chunk-KNEJTD6G.js";
+import "./chunk-SZLNNMIZ.js";
 export {
   AuthModule,
   GatewayClient,

package/dist/plugins/hermes/adapter.py

@@ -154,8 +154,13 @@ class KojeeTandemAdapter(BasePlatformAdapter):
 
     # ── Connection lifecycle ────────────────────────────────────────────
 
-    async def connect(self) -> bool:
-        """Start the loopback webhook listener the kojee-mcp daemon POSTs to."""
+    async def connect(self, *, is_reconnect: bool = False) -> bool:
+        """Start the loopback webhook listener the kojee-mcp daemon POSTs to.
+
+        ``is_reconnect`` is part of the BasePlatformAdapter.connect contract
+        (the gateway's reconnection watcher calls ``connect(is_reconnect=True)``);
+        this listener is stateless per-connect so the flag is accepted and ignored.
+        """
         if not self.webhook_secret:
             logger.error("kojee-tandem: KOJEE_WEBHOOK_SECRET must be set (signed-only inbound)")
             self._set_fatal_error(

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

@@ -5,20 +5,19 @@ import {
 } from "./chunk-XLRF5ATG.js";
 import {
   createCachedOpenclawWakeResolver,
-  postOpenclawWake
-} from "./chunk-NE2F5CKS.js";
+  postOpenclawAgent
+} from "./chunk-LKGKDZSO.js";
 import "./chunk-PHXO5P25.js";
 import {
   recordDelivered
 } from "./chunk-IZN7IZPW.js";
 import {
   claudeCodeAdapter
-} from "./chunk-TCWIXG5C.js";
-import "./chunk-A4IOKD4Z.js";
+} from "./chunk-CCVRXJJ2.js";
+import "./chunk-QYZP6QT2.js";
 import {
   VERSION
-} from "./chunk-5DHIUN73.js";
-import "./chunk-FJUAMJHU.js";
+} from "./chunk-6NPMVZD7.js";
 import "./chunk-PPTKGWFF.js";
 
 // src/delivery/lib/fanout.ts
@@ -122,14 +121,14 @@ function createClaudeCodeDelivery() {
         cleanupDiscoveryByKey,
         sweepStaleDiscovery
       } = await import("./session-discovery-NHCZ2XWA.js");
-      const { startEventLog, sweepStaleEventLogs } = await import("./event-log-2NBJEIEP.js");
+      const { startEventLog, sweepStaleEventLogs } = await import("./event-log-M22X3FAI.js");
       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-ATKYXDBV.js");
-      const { createMcpServer } = await import("./server-DU3LFS32.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-RURNIHHC.js");
+      const { resolveSharedSessionId } = await import("./cc-session-id-5HHQJ7VC.js");
       sweepStaleDiscovery();
       sweepStaleEventLogs();
       const projectDir = process.env["CLAUDE_PROJECT_DIR"];
@@ -255,6 +254,9 @@ function createClaudeCodeDelivery() {
         gateway: ctx.gateway,
         adapter: ctx.adapter,
         server,
+        // SEAT-INVITE #226 per-seat routing: this seat's stable seat_name, set
+        // per-seat in the fleet systemd env. Unset ⇒ legacy agent-wide wake.
+        seatName: process.env["CLAURON_SEAT_NAME"] || void 0,
         // eventLog is passed so the stream's status/heartbeat lines land in the
         // status sibling (emitStatus / heartbeat use opts.eventLog.appendStatus).
         // The PER-EVENT fan-out (queue/eventLog/channel/webhook) is owned by
@@ -319,12 +321,12 @@ function createWebhookDelivery(name, pendingLedger) {
   return {
     name,
     async start(ctx) {
-      const { startEventLog, sweepStaleEventLogs } = await import("./event-log-2NBJEIEP.js");
+      const { startEventLog, sweepStaleEventLogs } = await import("./event-log-M22X3FAI.js");
       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-ATKYXDBV.js");
-      const { createMcpServer } = await import("./server-DU3LFS32.js");
+      const { startEventStream } = await import("./event-stream-5ZEL7FXN.js");
+      const { createMcpServer } = await import("./server-VM3ZIGSZ.js");
       sweepStaleEventLogs();
       eventLog = startEventLog({
         key: ctx.instanceKey,
@@ -373,6 +375,9 @@ function createWebhookDelivery(name, pendingLedger) {
         gateway: ctx.gateway,
         adapter: ctx.adapter,
         server,
+        // SEAT-INVITE #226 per-seat routing: this seat's stable seat_name, set
+        // per-seat in the fleet systemd env. Unset ⇒ legacy agent-wide wake.
+        seatName: process.env["CLAURON_SEAT_NAME"] || void 0,
         eventLog,
         delivery: this,
         onConnected: /* @__PURE__ */ (() => {
@@ -501,24 +506,23 @@ function createCodexDelivery(onDelivered) {
 }
 
 // src/delivery/openclaw.ts
-function formatOpenclawNudge(event) {
-  const who = event.from?.member_id ?? "someone";
-  const body = (event.content?.body ?? "").replace(/\s+/g, " ").slice(0, 160);
-  return `New Kojee Tandem activity in ${event.tandem_id} from ${who}: "${body}". Catch up with tandem_messages / tandem_listen and reply via tandem_send.`;
+function formatOpenclawAgentPrompt(event) {
+  const since = Math.max(0, (event.cursor ?? 1) - 1);
+  return `You were mentioned in Kojee Tandem ${event.tandem_id}. Read it to see who and what \u2014 tandem_messages(tandem_id="${event.tandem_id}", since=${since}) \u2014 then REPLY IN THE FORUM now with tandem_send(tandem_id="${event.tandem_id}", body=..., reply_to="${event.id}"). Do this now; don't just read or ack.`;
 }
 function createOpenclawDelivery(deps = {}) {
   const resolveTarget = deps.resolveTarget ?? createCachedOpenclawWakeResolver();
-  const postWake = deps.postWake ?? postOpenclawWake;
+  const postAgent = deps.postAgent ?? postOpenclawAgent;
   let eventLog = null;
   let streamHandle = null;
   let warnedUnconfigured = false;
   return {
     name: "openclaw",
     async start(ctx) {
-      const { startEventLog, sweepStaleEventLogs } = await import("./event-log-2NBJEIEP.js");
+      const { startEventLog, sweepStaleEventLogs } = await import("./event-log-M22X3FAI.js");
       const { resubscribeMemberships } = await import("./resubscribe-G5OGDZJD.js");
-      const { startEventStream } = await import("./event-stream-ATKYXDBV.js");
-      const { createMcpServer } = await import("./server-DU3LFS32.js");
+      const { startEventStream } = await import("./event-stream-5ZEL7FXN.js");
+      const { createMcpServer } = await import("./server-VM3ZIGSZ.js");
       sweepStaleEventLogs();
       eventLog = startEventLog({
         key: ctx.instanceKey,
@@ -544,6 +548,9 @@ function createOpenclawDelivery(deps = {}) {
         gateway: ctx.gateway,
         adapter: ctx.adapter,
         server,
+        // SEAT-INVITE #226 per-seat routing: this seat's stable seat_name, set
+        // per-seat in the fleet systemd env. Unset ⇒ legacy agent-wide wake.
+        seatName: process.env["CLAURON_SEAT_NAME"] || void 0,
         eventLog,
         delivery: this,
         onConnected: /* @__PURE__ */ (() => {
@@ -587,8 +594,13 @@ function createOpenclawDelivery(deps = {}) {
           return;
         }
         warnedUnconfigured = false;
-        const res = await postWake(r.target, { text: formatOpenclawNudge(event), mode: "now" });
-        if (!res.ok) console.error(`[openclaw] wake POST failed: ${res.error ?? res.status}`);
+        const res = await postAgent(r.target, {
+          message: formatOpenclawAgentPrompt(event),
+          channel: "last",
+          name: "Kojee",
+          wakeMode: "now"
+        });
+        if (!res.ok) console.error(`[openclaw] agent wake POST failed: ${res.error ?? res.status}`);
       })().catch((err) => {
         console.error("[openclaw] wake delivery failed:", err);
       });
@@ -615,7 +627,7 @@ function selectDelivery(runtime, opts) {
     return createCodexDelivery(opts.onDelivered);
   }
   if (runtime === "openclaw") {
-    return createOpenclawDelivery();
+    return opts.headless ? createOpenclawDelivery() : null;
   }
   if (!needsWebhookEventStream(opts.env)) {
     return null;

package/dist/{send-cli-45RLGYIC.js → send-cli-WTY7H3BR.js}

@@ -13,7 +13,7 @@ import {
 import {
   GatewayClient,
   applyStableSessionId
-} from "./chunk-247WFMCJ.js";
+} from "./chunk-AGZ7ZGLY.js";
 import "./chunk-Z5LPNJQ6.js";
 import "./chunk-MIEI4PLB.js";
 import {
@@ -22,7 +22,7 @@ import {
 } from "./chunk-6G6YYST6.js";
 import "./chunk-U5HHHRXA.js";
 import "./chunk-PPTKGWFF.js";
-import "./chunk-KNEJTD6G.js";
+import "./chunk-SZLNNMIZ.js";
 
 // src/tandem/send-cli.ts
 import os from "os";

package/dist/{server-DU3LFS32.js → server-VM3ZIGSZ.js}

@@ -5,9 +5,8 @@ import {
   executeToolCall,
   extractDrainCursor,
   startMcpServer
-} from "./chunk-A4IOKD4Z.js";
-import "./chunk-5DHIUN73.js";
-import "./chunk-FJUAMJHU.js";
+} from "./chunk-QYZP6QT2.js";
+import "./chunk-6NPMVZD7.js";
 import "./chunk-PPTKGWFF.js";
 export {
   buildChannelInstructions,

package/dist/session-start-hook-VL3KYDTT.js

@@ -0,0 +1,25 @@
+import {
+  readHookStdin
+} from "./chunk-NIIBVKLP.js";
+import {
+  buildSessionStartReminder
+} from "./chunk-6NPMVZD7.js";
+
+// src/hooks/session-start-hook.ts
+async function runSessionStartHook() {
+  let source = null;
+  try {
+    ({ source } = await readHookStdin());
+  } catch {
+  }
+  const out = {
+    hookSpecificOutput: {
+      hookEventName: "SessionStart",
+      additionalContext: buildSessionStartReminder(source)
+    }
+  };
+  process.stdout.write(JSON.stringify(out));
+}
+export {
+  runSessionStartHook
+};

package/dist/{setup-handler-44ASXYMS.js → setup-handler-GNAIWAYU.js}

@@ -3,16 +3,17 @@ import {
   pairSlotFor,
   reconcileConnectPairSlot,
   runWizard
-} from "./chunk-XPIW4N55.js";
-import "./chunk-6XWTUDWW.js";
+} from "./chunk-N2YAZRAD.js";
+import "./chunk-WDWVBPXA.js";
 import "./chunk-E6WMFMM2.js";
+import "./chunk-GEGUWQYT.js";
+import "./chunk-EIH2LNF4.js";
+import "./chunk-RDLF4NQC.js";
 import {
   isWizardRuntime
 } from "./chunk-77HWBSRH.js";
-import "./chunk-TMCNB4JH.js";
 import "./chunk-D6JKFJ6A.js";
-import "./chunk-EIH2LNF4.js";
-import "./chunk-RDLF4NQC.js";
+import "./chunk-AXBJQJKA.js";
 import "./chunk-SQL56SEB.js";
 import "./chunk-V5VZPYMZ.js";
 import {
@@ -25,8 +26,7 @@ import "./chunk-I67C2HYA.js";
 import "./chunk-MIEI4PLB.js";
 import "./chunk-6G6YYST6.js";
 import "./chunk-U5HHHRXA.js";
-import "./chunk-5DHIUN73.js";
-import "./chunk-FJUAMJHU.js";
+import "./chunk-6NPMVZD7.js";
 
 // src/wizard/setup-handler.ts
 var SETUP_SUPPORTED_RUNTIMES = ["claude-code", "codex"];

package/dist/{stop-hook-N6TX4YQT.js → stop-hook-BLPYRE7T.js}

@@ -1,10 +1,10 @@
 import "./chunk-XLKGPGZT.js";
 import {
   resolveHookDiscovery
-} from "./chunk-WBXU27BF.js";
+} from "./chunk-FNMKP34Y.js";
 import {
   readHookStdin
-} from "./chunk-LSUB6QMP.js";
+} from "./chunk-NIIBVKLP.js";
 import {
   controlTokenAuthHeaders
 } from "./chunk-GKXHKR3B.js";
@@ -14,14 +14,14 @@ import {
 import {
   monitorHeartbeatPath,
   nudgeSentinelPath
-} from "./chunk-TNZITJAB.js";
+} from "./chunk-WVQU3QQ7.js";
 import "./chunk-67F67AQ6.js";
 import "./chunk-U5HHHRXA.js";
 import {
   buildMonitorNudge
-} from "./chunk-FJUAMJHU.js";
+} from "./chunk-6NPMVZD7.js";
 import "./chunk-XJEBJIQE.js";
-import "./chunk-KNEJTD6G.js";
+import "./chunk-SZLNNMIZ.js";
 
 // src/hooks/stop-hook.ts
 import fs from "fs";

package/dist/stream-watchdog-K2AWNCQW.js

@@ -0,0 +1,64 @@
+// src/runtime/stream-watchdog.ts
+var DEFAULT_STREAM_THRESHOLD_MS = 9e4;
+var DEFAULT_STREAM_INTERVAL_MS = 15e3;
+function createStreamWatchdog(opts) {
+  const thresholdMs = opts.thresholdMs ?? DEFAULT_STREAM_THRESHOLD_MS;
+  const intervalMs = opts.intervalMs ?? DEFAULT_STREAM_INTERVAL_MS;
+  const now = opts.now ?? Date.now;
+  const reArm = opts.reArmAfterUnhealthy === true;
+  let timer = null;
+  let fired = false;
+  let lastHealthyAt = now();
+  let lastSeenEventAt = null;
+  function stop() {
+    if (timer !== null) {
+      clearInterval(timer);
+      timer = null;
+    }
+  }
+  function check() {
+    if (fired) return;
+    let state;
+    try {
+      state = opts.getState();
+    } catch {
+      return;
+    }
+    const t = now();
+    const eventAdvanced = state.lastEventAt !== null && state.lastEventAt !== lastSeenEventAt;
+    if (state.lastEventAt !== null) lastSeenEventAt = state.lastEventAt;
+    if (state.connected || eventAdvanced) {
+      lastHealthyAt = t;
+      return;
+    }
+    const disconnectedForMs = t - lastHealthyAt;
+    if (disconnectedForMs > thresholdMs) {
+      fired = true;
+      if (!reArm) stop();
+      try {
+        opts.onUnhealthy({
+          disconnectedForMs,
+          reason: `SSE stream unhealthy for ${Math.round(disconnectedForMs / 1e3)}s (connected=false, no new events) \u2014 reconnect loop presumed wedged`
+        });
+      } catch {
+      }
+      if (reArm) {
+        fired = false;
+        lastHealthyAt = now();
+      }
+    }
+  }
+  return {
+    start() {
+      if (timer !== null || fired) return;
+      timer = setInterval(() => check(), intervalMs);
+      timer.unref?.();
+    },
+    stop
+  };
+}
+export {
+  DEFAULT_STREAM_INTERVAL_MS,
+  DEFAULT_STREAM_THRESHOLD_MS,
+  createStreamWatchdog
+};