context-mode 1.0.141 → 1.0.142

package/start.mjs

@@ -364,16 +364,47 @@ if (!process.env.VITEST) {
 // Ensure native dependencies + ABI compatibility (shared with hooks via ensure-deps.mjs)
 // ensure-deps handles better-sqlite3 install + ABI cache/rebuild automatically (#148, #203)
 import "./hooks/ensure-deps.mjs";
-// Also install pure-JS deps used by server
-for (const pkg of ["turndown", "turndown-plugin-gfm", "@mixmark-io/domino"]) {
-  if (!existsSync(resolve(__dirname, "node_modules", pkg))) {
+// Pure-JS runtime deps used only by `ctx_fetch_and_index` (HTML → Markdown
+// pipeline runs in a sandboxed subprocess that `require.resolve()`s these at
+// call time). Plugin distributions that bypass `npm install` — most notably
+// codex's marketplace, which git-clones into `~/.codex/plugins/cache/<pkg>/`
+// without installing dependencies — land here with no `node_modules/`.
+//
+// Before #634: synchronous `execSync("npm install …")` per package
+// (turndown + turndown-plugin-gfm + @mixmark-io/domino) blocked MCP boot
+// for ~15–25s cold. Codex's per-MCP `startup_timeout_sec` is 30s, so on
+// any host where its prewarm + DNS already eats a few seconds the timer
+// fires before context-mode replies to `initialize` and the MCP child is
+// dropped with "MCP client for `context-mode` timed out after 30 seconds".
+//
+// Fix: spawn each `npm install` detached + unref'd so it runs in the
+// background while the MCP server proceeds with its handshake. The deps
+// land asynchronously, well before any LLM-driven `ctx_fetch_and_index`
+// call can plausibly fire. If a user invokes that tool faster than the
+// install completes, the subprocess's own `require.resolve("turndown")`
+// failure surfaces a typed error to the caller — same posture as any
+// other missing-runtime-dep situation in that code path.
+{
+  const NPM_INSTALL_BG_PKGS = ["turndown", "turndown-plugin-gfm", "@mixmark-io/domino"];
+  const IS_WIN32 = process.platform === "win32";
+  const NPM_BIN = IS_WIN32 ? "npm.cmd" : "npm";
+  for (const pkg of NPM_INSTALL_BG_PKGS) {
+    if (existsSync(resolve(__dirname, "node_modules", pkg))) continue;
     try {
-      execSync(`npm install ${pkg} --no-package-lock --no-save --silent`, {
-        cwd: __dirname,
-        stdio: "pipe",
-        timeout: 120000,
-      });
-    } catch { /* best effort */ }
+      const child = spawn(
+        NPM_BIN,
+        ["install", pkg, "--no-package-lock", "--no-save", "--silent", "--no-audit", "--no-fund"],
+        {
+          cwd: __dirname,
+          stdio: "ignore",
+          detached: true,
+          // npm on Windows ships as a `.cmd` shim — must go through cmd.exe.
+          shell: IS_WIN32,
+        },
+      );
+      child.on("error", () => { /* best effort — npm missing, broken cache, etc. */ });
+      child.unref();
+    } catch { /* best effort — never block MCP boot */ }
   }
 }
 

package/build/openclaw-plugin.d.ts

@@ -1,130 +0,0 @@
-/**
- * OpenClaw TypeScript plugin entry point for context-mode.
- *
- * Exports an object with { id, name, configSchema, register(api) } for
- * declarative metadata and config validation before code execution.
- *
- * register(api) registers:
- *   - before_tool_call hook   — Routing enforcement (deny/modify/passthrough)
- *   - after_tool_call hook    — Session event capture
- *   - command:new hook         — Session initialization and cleanup
- *   - session_start hook             — Re-key DB session to OpenClaw's session ID
- *   - before_compaction hook         — Flush events to resume snapshot
- *   - after_compaction hook          — Increment compact count
- *   - before_prompt_build (p=10)  — Resume snapshot injection into system context
- *   - before_prompt_build (p=5)   — Routing instruction injection into system context
- *   - context-mode engine      — Context engine with compaction management
- *   - /ctx-stats command       — Auto-reply command for session statistics
- *   - /ctx-doctor command      — Auto-reply command for diagnostics
- *   - /ctx-upgrade command     — Auto-reply command for upgrade
- *
- * Loaded by OpenClaw via: openclaw.extensions entry in package.json
- *
- * OpenClaw plugin paradigm:
- *   - Plugins export { id, name, configSchema, register(api) } for metadata
- *   - api.registerHook() for event-driven hooks
- *   - api.on() for typed lifecycle hooks
- *   - api.registerContextEngine() for compaction ownership
- *   - api.registerCommand() for auto-reply slash commands
- *   - Plugins run in-process with the Gateway (trusted code)
- */
-import type { OpenClawToolDef } from "./openclaw/mcp-tools.js";
-/** Context for auto-reply command handlers. */
-interface CommandContext {
-    senderId?: string;
-    channel?: string;
-    isAuthorizedSender?: boolean;
-    args?: string;
-    commandBody?: string;
-    config?: Record<string, unknown>;
-}
-/** OpenClaw plugin API provided to the register function. */
-interface OpenClawPluginApi {
-    registerHook(event: string, handler: (...args: unknown[]) => unknown, meta: {
-        name: string;
-        description: string;
-    }): void;
-    /**
-     * Register a typed lifecycle hook.
-     * Supported names: "session_start", "before_compaction", "after_compaction",
-     * "before_prompt_build"
-     */
-    on(event: string, handler: (...args: unknown[]) => unknown, opts?: {
-        priority?: number;
-    }): void;
-    registerContextEngine(id: string, factory: () => ContextEngineInstance): void;
-    registerCommand?(cmd: {
-        name: string;
-        description: string;
-        acceptsArgs?: boolean;
-        requireAuth?: boolean;
-        handler: (ctx: CommandContext) => {
-            text: string;
-        } | Promise<{
-            text: string;
-        }>;
-    }): void;
-    registerCli?(factory: (ctx: {
-        program: unknown;
-    }) => void, meta: {
-        commands: string[];
-    }): void;
-    /**
-     * Register an agent tool (OpenClaw native registerTool) — see
-     * refs/platforms/openclaw/docs/plugins/building-plugins.md:116. Optional in
-     * the type so we degrade silently on legacy hosts that pre-date this API.
-     */
-    registerTool?(tool: OpenClawToolDef, opts?: {
-        optional?: boolean;
-    }): void;
-    logger?: {
-        info: (...args: unknown[]) => void;
-        error: (...args: unknown[]) => void;
-        debug?: (...args: unknown[]) => void;
-        warn?: (...args: unknown[]) => void;
-    };
-}
-/** Context engine instance returned by the factory. */
-interface ContextEngineInstance {
-    info: {
-        id: string;
-        name: string;
-        ownsCompaction: boolean;
-    };
-    ingest(data: unknown): Promise<{
-        ingested: boolean;
-    }>;
-    assemble(ctx: {
-        messages: unknown[];
-    }): Promise<{
-        messages: unknown[];
-        estimatedTokens: number;
-    }>;
-    compact(): Promise<{
-        ok: boolean;
-        compacted: boolean;
-    }>;
-}
-/**
- * OpenClaw plugin definition. The object form provides declarative metadata
- * (id, name, configSchema) that OpenClaw can read without executing code.
- * register() is called once per agent session with a fresh api object.
- * Each call creates isolated closures (db, sessionId, hooks) — no shared state.
- */
-declare const _default: {
-    id: string;
-    name: string;
-    configSchema: {
-        type: "object";
-        properties: {
-            enabled: {
-                type: "boolean";
-                default: boolean;
-                description: string;
-            };
-        };
-        additionalProperties: boolean;
-    };
-    register(api: OpenClawPluginApi): void;
-};
-export default _default;