@wipcomputer/wip-ldm-os 0.4.73-alpha.9 → 0.4.75-alpha.1

package/dist/bridge/chunk-3RG5ZIWI.js

@@ -0,0 +1,10 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+export {
+  __require
+};

package/dist/bridge/{chunk-LF7EMFBY.js → chunk-7NH6JBIO.js}

@@ -1,3 +1,7 @@
+import {
+  __require
+} from "./chunk-3RG5ZIWI.js";
+
 // core.ts
 import { execSync, exec } from "child_process";
 import { readdirSync, readFileSync, writeFileSync, existsSync, statSync, mkdirSync, renameSync, unlinkSync } from "fs";
@@ -6,6 +10,27 @@ import { homedir } from "os";
 import { promisify } from "util";
 import { randomUUID } from "crypto";
 var execAsync = promisify(exec);
+var GATEWAY_HOST = "127.0.0.1";
+var DEFAULT_GATEWAY_PORT = 18789;
+var DEFAULT_INBOX_PORT = 18790;
+var GATEWAY_TIMEOUT_MS = 12e4;
+var OP_CLI_TIMEOUT_MS = 1e4;
+var EMBEDDING_API_URL = "https://api.openai.com/v1/embeddings";
+var DEFAULT_EMBEDDING_MODEL = "text-embedding-3-small";
+var DEFAULT_EMBEDDING_DIMS = 1536;
+var VECTOR_SEARCH_ROW_LIMIT = 1e3;
+var RECENCY_DECAY_RATE = 0.01;
+var RECENCY_FLOOR = 0.5;
+var FRESHNESS_FRESH_DAYS = 3;
+var FRESHNESS_RECENT_DAYS = 7;
+var FRESHNESS_AGING_DAYS = 14;
+var DEFAULT_SEARCH_LIMIT = 5;
+var WORKSPACE_MAX_DEPTH = 4;
+var WORKSPACE_MAX_EXCERPTS = 5;
+var WORKSPACE_MAX_RESULTS = 10;
+var SKILL_EXEC_TIMEOUT_MS = 12e4;
+var SKILL_EXEC_MAX_BUFFER = 10 * 1024 * 1024;
+var MS_PER_DAY = 1e3 * 60 * 60 * 24;
 var HOME = process.env.HOME || homedir();
 var LDM_ROOT = process.env.LDM_ROOT || join(HOME, ".ldm");
 function resolveConfig(overrides) {
@@ -14,9 +39,9 @@ function resolveConfig(overrides) {
     openclawDir,
     workspaceDir: overrides?.workspaceDir || join(openclawDir, "workspace"),
     dbPath: overrides?.dbPath || join(openclawDir, "memory", "context-embeddings.sqlite"),
-    inboxPort: overrides?.inboxPort || parseInt(process.env.LESA_BRIDGE_INBOX_PORT || "18790", 10),
-    embeddingModel: overrides?.embeddingModel || "text-embedding-3-small",
-    embeddingDimensions: overrides?.embeddingDimensions || 1536
+    inboxPort: overrides?.inboxPort || parseInt(process.env.LESA_BRIDGE_INBOX_PORT || String(DEFAULT_INBOX_PORT), 10),
+    embeddingModel: overrides?.embeddingModel || DEFAULT_EMBEDDING_MODEL,
+    embeddingDimensions: overrides?.embeddingDimensions || DEFAULT_EMBEDDING_DIMS
   };
 }
 function resolveConfigMulti(overrides) {
@@ -29,9 +54,9 @@ function resolveConfigMulti(overrides) {
         openclawDir,
         workspaceDir: raw.workspaceDir || overrides?.workspaceDir || join(openclawDir, "workspace"),
         dbPath: raw.dbPath || overrides?.dbPath || join(openclawDir, "memory", "context-embeddings.sqlite"),
-        inboxPort: raw.inboxPort || overrides?.inboxPort || parseInt(process.env.LESA_BRIDGE_INBOX_PORT || "18790", 10),
-        embeddingModel: raw.embeddingModel || overrides?.embeddingModel || "text-embedding-3-small",
-        embeddingDimensions: raw.embeddingDimensions || overrides?.embeddingDimensions || 1536
+        inboxPort: raw.inboxPort || overrides?.inboxPort || parseInt(process.env.LESA_BRIDGE_INBOX_PORT || String(DEFAULT_INBOX_PORT), 10),
+        embeddingModel: raw.embeddingModel || overrides?.embeddingModel || DEFAULT_EMBEDDING_MODEL,
+        embeddingDimensions: raw.embeddingDimensions || overrides?.embeddingDimensions || DEFAULT_EMBEDDING_DIMS
       };
     } catch {
     }
@@ -53,7 +78,7 @@ function resolveApiKey(openclawDir) {
         `op read "op://Agent Secrets/OpenAI API/api key" 2>/dev/null`,
         {
           env: { ...process.env, OP_SERVICE_ACCOUNT_TOKEN: saToken },
-          timeout: 1e4,
+          timeout: OP_CLI_TIMEOUT_MS,
           encoding: "utf-8"
         }
       ).trim();
@@ -76,7 +101,7 @@ function resolveGatewayConfig(openclawDir) {
   }
   const config = JSON.parse(readFileSync(configPath, "utf-8"));
   const token = config?.gateway?.auth?.token;
-  const port = config?.gateway?.port || 18789;
+  const port = config?.gateway?.port || DEFAULT_GATEWAY_PORT;
   if (!token) {
     throw new Error("No gateway.auth.token found in openclaw.json");
   }
@@ -94,10 +119,34 @@ function setSessionIdentity(agentId, sessionName) {
 function getSessionIdentity() {
   return { agentId: _sessionAgentId, sessionName: _sessionName };
 }
+function refreshSessionIdentity() {
+  try {
+    const sessionPath = join(
+      process.env.HOME || __require("os").homedir(),
+      ".claude",
+      "sessions",
+      `${process.ppid}.json`
+    );
+    const data = JSON.parse(readFileSync(sessionPath, "utf-8"));
+    if (data.name && typeof data.name === "string" && data.name !== _sessionName) {
+      const oldName = _sessionName;
+      _sessionName = data.name;
+      try {
+        registerBridgeSession();
+      } catch {
+      }
+      if (oldName !== _sessionName) {
+        process.stderr.write(`wip-bridge: session name updated: ${oldName} -> ${_sessionName}
+`);
+      }
+    }
+  } catch {
+  }
+}
 function parseTarget(to) {
   if (to === "*") return { agent: "*", session: "*" };
   const colonIdx = to.indexOf(":");
-  if (colonIdx === -1) return { agent: to, session: "default" };
+  if (colonIdx === -1) return { agent: to, session: "*" };
   return { agent: to.slice(0, colonIdx), session: to.slice(colonIdx + 1) };
 }
 function messageMatchesSession(msgTo, agentId, sessionName) {
@@ -127,6 +176,7 @@ function pushInbox(msg) {
   }
 }
 function drainInbox() {
+  refreshSessionIdentity();
   try {
     if (!existsSync(MESSAGES_DIR)) return [];
     const files = readdirSync(MESSAGES_DIR).filter((f) => f.endsWith(".json"));
@@ -157,6 +207,7 @@ function drainInbox() {
   }
 }
 function inboxCount() {
+  refreshSessionIdentity();
   try {
     if (!existsSync(MESSAGES_DIR)) return 0;
     const files = readdirSync(MESSAGES_DIR).filter((f) => f.endsWith(".json"));
@@ -262,37 +313,64 @@ async function sendMessage(openclawDir, message, options) {
   const { token, port } = resolveGatewayConfig(openclawDir);
   const agentId = options?.agentId || "main";
   const senderLabel = options?.senderLabel || "Claude Code";
-  const response = await fetch(`http://127.0.0.1:${port}/v1/chat/completions`, {
-    method: "POST",
-    headers: {
-      Authorization: `Bearer ${token}`,
-      "Content-Type": "application/json",
-      "x-openclaw-scopes": "operator.read,operator.write",
-      "x-openclaw-session-key": `agent:${agentId}:main`
-    },
-    body: JSON.stringify({
-      model: `openclaw/${agentId}`,
-      messages: [
-        {
-          role: "user",
-          content: `[${senderLabel}]: ${message}`
-        }
-      ]
-    })
+  const fireAndForget = options?.fireAndForget ?? false;
+  const requestBody = JSON.stringify({
+    model: `openclaw/${agentId}`,
+    messages: [
+      {
+        role: "user",
+        content: `[${senderLabel}]: ${message}`
+      }
+    ]
   });
-  if (!response.ok) {
-    const body = await response.text();
-    throw new Error(`Gateway returned ${response.status}: ${body}`);
+  const requestHeaders = {
+    Authorization: `Bearer ${token}`,
+    "Content-Type": "application/json",
+    "x-openclaw-scopes": "operator.read,operator.write",
+    "x-openclaw-session-key": `agent:${agentId}:main`
+  };
+  const url = `http://${GATEWAY_HOST}:${port}/v1/chat/completions`;
+  if (fireAndForget) {
+    fetch(url, {
+      method: "POST",
+      headers: requestHeaders,
+      body: requestBody
+    }).catch(() => {
+    });
+    return "Message sent (queued). Response will arrive in the TUI.";
   }
-  const data = await response.json();
-  const reply = data.choices?.[0]?.message?.content;
-  if (!reply) {
-    throw new Error("No response content from gateway");
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), GATEWAY_TIMEOUT_MS);
+  try {
+    const response = await fetch(url, {
+      method: "POST",
+      headers: requestHeaders,
+      body: requestBody,
+      signal: controller.signal
+    });
+    clearTimeout(timeoutId);
+    if (!response.ok) {
+      const body = await response.text();
+      throw new Error(`Gateway returned ${response.status}: ${body}`);
+    }
+    const data = await response.json();
+    const reply = data.choices?.[0]?.message?.content;
+    if (!reply) {
+      throw new Error("No response content from gateway");
+    }
+    return reply;
+  } catch (err) {
+    clearTimeout(timeoutId);
+    if (err.name === "AbortError") {
+      throw new Error(
+        "Gateway timeout: Lesa may be busy or the gateway is processing another request. Try again in a moment."
+      );
+    }
+    throw err;
   }
-  return reply;
 }
-async function getQueryEmbedding(text, apiKey, model = "text-embedding-3-small", dimensions = 1536) {
-  const response = await fetch("https://api.openai.com/v1/embeddings", {
+async function getQueryEmbedding(text, apiKey, model = DEFAULT_EMBEDDING_MODEL, dimensions = DEFAULT_EMBEDDING_DIMS) {
+  const response = await fetch(EMBEDDING_API_URL, {
     method: "POST",
     headers: {
       Authorization: `Bearer ${apiKey}`,
@@ -331,15 +409,15 @@ function cosineSimilarity(a, b) {
   return denom === 0 ? 0 : dot / denom;
 }
 function recencyWeight(ageDays) {
-  return Math.max(0.5, 1 - ageDays * 0.01);
+  return Math.max(RECENCY_FLOOR, 1 - ageDays * RECENCY_DECAY_RATE);
 }
 function freshnessLabel(ageDays) {
-  if (ageDays < 3) return "fresh";
-  if (ageDays < 7) return "recent";
-  if (ageDays < 14) return "aging";
+  if (ageDays < FRESHNESS_FRESH_DAYS) return "fresh";
+  if (ageDays < FRESHNESS_RECENT_DAYS) return "recent";
+  if (ageDays < FRESHNESS_AGING_DAYS) return "aging";
   return "stale";
 }
-async function searchConversations(config, query, limit = 5) {
+async function searchConversations(config, query, limit = DEFAULT_SEARCH_LIMIT) {
   const Database = (await import("better-sqlite3")).default;
   if (!existsSync(config.dbPath)) {
     throw new Error(`Database not found: ${config.dbPath}`);
@@ -360,12 +438,12 @@ async function searchConversations(config, query, limit = 5) {
            FROM conversation_chunks
            WHERE embedding IS NOT NULL
            ORDER BY timestamp DESC
-           LIMIT 1000`
+           LIMIT ${VECTOR_SEARCH_ROW_LIMIT}`
       ).all();
       const now = Date.now();
       return rows.map((row) => {
         const cosine = cosineSimilarity(queryEmbedding, blobToEmbedding(row.embedding));
-        const ageDays = (now - row.timestamp) / (1e3 * 60 * 60 * 24);
+        const ageDays = (now - row.timestamp) / MS_PER_DAY;
         const weight = recencyWeight(ageDays);
         return {
           text: row.chunk_text,
@@ -396,7 +474,7 @@ async function searchConversations(config, query, limit = 5) {
     db.close();
   }
 }
-function findMarkdownFiles(dir, maxDepth = 4, depth = 0) {
+function findMarkdownFiles(dir, maxDepth = WORKSPACE_MAX_DEPTH, depth = 0) {
   if (depth > maxDepth || !existsSync(dir)) return [];
   const files = [];
   for (const entry of readdirSync(dir, { withFileTypes: true })) {
@@ -426,7 +504,7 @@ function searchWorkspace(workspaceDir, query) {
       if (score === 0) continue;
       const lines = content.split("\n");
       const excerpts = [];
-      for (let i = 0; i < lines.length && excerpts.length < 5; i++) {
+      for (let i = 0; i < lines.length && excerpts.length < WORKSPACE_MAX_EXCERPTS; i++) {
         const lineLower = lines[i].toLowerCase();
         if (words.some((w) => lineLower.includes(w))) {
           const start = Math.max(0, i - 1);
@@ -438,7 +516,7 @@ function searchWorkspace(workspaceDir, query) {
     } catch {
     }
   }
-  return results.sort((a, b) => b.score - a.score).slice(0, 10);
+  return results.sort((a, b) => b.score - a.score).slice(0, WORKSPACE_MAX_RESULTS);
 }
 function parseSkillFrontmatter(content) {
   const match = content.match(/^---\n([\s\S]*?)\n---/);
@@ -532,9 +610,8 @@ async function executeSkillScript(skillDir, scripts, scriptName, args) {
       `${interpreter} "${scriptPath}" ${args}`,
       {
         env: { ...process.env },
-        timeout: 12e4,
-        maxBuffer: 10 * 1024 * 1024
-        // 10MB
+        timeout: SKILL_EXEC_TIMEOUT_MS,
+        maxBuffer: SKILL_EXEC_MAX_BUFFER
       }
     );
     return stdout || stderr || "(no output)";
@@ -574,6 +651,7 @@ export {
   resolveGatewayConfig,
   setSessionIdentity,
   getSessionIdentity,
+  refreshSessionIdentity,
   pushInbox,
   drainInbox,
   inboxCount,

package/dist/bridge/cli.js

@@ -8,7 +8,8 @@ import {
   searchConversations,
   searchWorkspace,
   sendMessage
-} from "./chunk-LF7EMFBY.js";
+} from "./chunk-7NH6JBIO.js";
+import "./chunk-3RG5ZIWI.js";
 
 // cli.ts
 import { existsSync, statSync } from "fs";

package/dist/bridge/core.d.ts

@@ -49,6 +49,17 @@ declare function getSessionIdentity(): {
     agentId: string;
     sessionName: string;
 };
+/**
+ * Re-read the session name from CC's session metadata file.
+ *
+ * CC writes the /rename label to ~/.claude/sessions/<pid>.json. The bridge
+ * reads this once on boot, but the name can change at any time via /rename
+ * or /resume. Calling this before each inbox check ensures the bridge
+ * always uses the current label for message targeting.
+ *
+ * Cheap: one file read per call. No network. No delay.
+ */
+declare function refreshSessionIdentity(): void;
 /**
  * Write a message to the file-based inbox.
  * Creates a JSON file at ~/.ldm/messages/{uuid}.json.
@@ -107,6 +118,7 @@ declare function sendMessage(openclawDir: string, message: string, options?: {
     agentId?: string;
     user?: string;
     senderLabel?: string;
+    fireAndForget?: boolean;
 }): Promise<string>;
 declare function getQueryEmbedding(text: string, apiKey: string, model?: string, dimensions?: number): Promise<number[]>;
 declare function blobToEmbedding(blob: Buffer): number[];
@@ -132,4 +144,4 @@ declare function discoverSkills(openclawDir: string): SkillInfo[];
 declare function executeSkillScript(skillDir: string, scripts: string[], scriptName: string | undefined, args: string): Promise<string>;
 declare function readWorkspaceFile(workspaceDir: string, filePath: string): WorkspaceFileResult;
 
-export { type BridgeConfig, type ConversationResult, type GatewayConfig, type InboxMessage, LDM_ROOT, type SessionInfo, type SkillInfo, type WorkspaceFileResult, type WorkspaceSearchResult, blobToEmbedding, cosineSimilarity, discoverSkills, drainInbox, executeSkillScript, findMarkdownFiles, getQueryEmbedding, getSessionIdentity, inboxCount, inboxCountBySession, listActiveSessions, pushInbox, readWorkspaceFile, registerBridgeSession, resolveApiKey, resolveConfig, resolveConfigMulti, resolveGatewayConfig, searchConversations, searchWorkspace, sendLdmMessage, sendMessage, setSessionIdentity };
+export { type BridgeConfig, type ConversationResult, type GatewayConfig, type InboxMessage, LDM_ROOT, type SessionInfo, type SkillInfo, type WorkspaceFileResult, type WorkspaceSearchResult, blobToEmbedding, cosineSimilarity, discoverSkills, drainInbox, executeSkillScript, findMarkdownFiles, getQueryEmbedding, getSessionIdentity, inboxCount, inboxCountBySession, listActiveSessions, pushInbox, readWorkspaceFile, refreshSessionIdentity, registerBridgeSession, resolveApiKey, resolveConfig, resolveConfigMulti, resolveGatewayConfig, searchConversations, searchWorkspace, sendLdmMessage, sendMessage, setSessionIdentity };

package/dist/bridge/core.js

@@ -13,6 +13,7 @@ import {
   listActiveSessions,
   pushInbox,
   readWorkspaceFile,
+  refreshSessionIdentity,
   registerBridgeSession,
   resolveApiKey,
   resolveConfig,
@@ -23,7 +24,8 @@ import {
   sendLdmMessage,
   sendMessage,
   setSessionIdentity
-} from "./chunk-LF7EMFBY.js";
+} from "./chunk-7NH6JBIO.js";
+import "./chunk-3RG5ZIWI.js";
 export {
   LDM_ROOT,
   blobToEmbedding,
@@ -39,6 +41,7 @@ export {
   listActiveSessions,
   pushInbox,
   readWorkspaceFile,
+  refreshSessionIdentity,
   registerBridgeSession,
   resolveApiKey,
   resolveConfig,

package/dist/bridge/mcp-server.js

@@ -15,13 +15,16 @@ import {
   sendLdmMessage,
   sendMessage,
   setSessionIdentity
-} from "./chunk-LF7EMFBY.js";
+} from "./chunk-7NH6JBIO.js";
+import {
+  __require
+} from "./chunk-3RG5ZIWI.js";
 
 // mcp-server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { createServer } from "http";
-import { appendFileSync, mkdirSync } from "fs";
+import { appendFileSync, mkdirSync, readFileSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";
 import { z } from "zod";
@@ -191,15 +194,29 @@ ${result.content}` }] };
 server.registerTool(
   "lesa_send_message",
   {
-    description: "Send a message to the OpenClaw agent through the gateway. Routes through the agent's full pipeline: memory, tools, personality, workspace. Use this for direct communication: asking questions, sharing findings, coordinating work, or having a discussion. Messages are prefixed with [Claude Code] so the agent knows the source.",
+    description: "Send a message to the OpenClaw agent through the gateway. Routes through the agent's full pipeline: memory, tools, personality, workspace. Use this for direct communication: asking questions, sharing findings, coordinating work, or having a discussion. Messages are prefixed with [Claude Code] so the agent knows the source.\n\nThis is async: returns immediately after sending. The agent's reply will arrive in your inbox (check via lesa_check_inbox or it appears automatically on your next turn).",
     inputSchema: {
       message: z.string().describe("Message to send to the OpenClaw agent")
     }
   },
   async ({ message }) => {
     try {
-      const reply = await sendMessage(config.openclawDir, message);
-      return { content: [{ type: "text", text: reply }] };
+      await sendMessage(config.openclawDir, message, { fireAndForget: true });
+      const { agentId, sessionName } = getSessionIdentity();
+      sendLdmMessage({
+        from: `${agentId}:${sessionName}`,
+        to: "lesa",
+        body: message,
+        type: "chat"
+      });
+      return {
+        content: [{
+          type: "text",
+          text: `Sent to L\u0113sa: "${message}"
+
+Message delivered to the gateway (fire-and-forget). L\u0113sa will process it through her full pipeline. Her reply will arrive in your inbox. Use lesa_check_inbox to check, or it will appear automatically on your next turn.`
+        }]
+      };
     } catch (err) {
       return { content: [{ type: "text", text: `Error sending message: ${err.message}` }], isError: true };
     }
@@ -308,11 +325,39 @@ ${lines.join("\n")}` }] };
   );
   console.error(`wip-bridge: registered ${executableSkills.length} skill tools + oc_skills_list (${skills.length} total skills)`);
 }
+function resolveSessionName() {
+  const ccSessionDir = join(process.env.HOME || homedir(), ".claude", "sessions");
+  const ccSessionPath = join(ccSessionDir, `${process.ppid}.json`);
+  for (let attempt = 0; attempt < 3; attempt++) {
+    try {
+      const data = JSON.parse(readFileSync(ccSessionPath, "utf-8"));
+      if (data.name && typeof data.name === "string") {
+        return data.name;
+      }
+      if (attempt < 2) {
+        const { execSync } = __require("child_process");
+        execSync("sleep 0.5", { stdio: "ignore" });
+      }
+    } catch {
+      if (attempt < 2) {
+        try {
+          const { execSync } = __require("child_process");
+          execSync("sleep 0.5", { stdio: "ignore" });
+        } catch {
+        }
+      }
+    }
+  }
+  if (process.env.LDM_SESSION_NAME) {
+    return process.env.LDM_SESSION_NAME;
+  }
+  return "default";
+}
 async function main() {
   const agentId = process.env.LDM_AGENT_ID || "cc-mini";
-  const sessionName = process.env.LDM_SESSION_NAME || "default";
+  const sessionName = resolveSessionName();
   setSessionIdentity(agentId, sessionName);
-  console.error(`wip-bridge: session identity: ${agentId}:${sessionName}`);
+  console.error(`wip-bridge: session identity: ${agentId}:${sessionName} (resolved from ${sessionName !== "default" ? "CC session file or env" : "default"})`);
   const session = registerBridgeSession();
   if (session) {
     console.error(`wip-bridge: registered session ${agentId}--${sessionName} (pid ${session.pid})`);

package/dist/bridge/openclaw.d.ts

@@ -0,0 +1,5 @@
+declare const _default: {
+    register(api: any): void;
+};
+
+export { _default as default };

package/dist/bridge/openclaw.js

@@ -0,0 +1,11 @@
+import "./chunk-3RG5ZIWI.js";
+
+// openclaw.ts
+var openclaw_default = {
+  register(api) {
+    api.logger.info("lesa-bridge plugin registered (skill-only; MCP server runs out of process)");
+  }
+};
+export {
+  openclaw_default as default
+};

package/docs/bridge/TECHNICAL.md

@@ -100,6 +100,92 @@ This enables CC-to-CC awareness without a broker daemon. Any session can discove
 | `lib/sessions.mjs` | Session registration, discovery, PID liveness |
 | `dist/bridge/` | Compiled output (ships with npm package) |
 
+## ChatCompletions Routing (Fork Patches)
+
+OpenClaw's gateway exposes an OpenAI-compatible chatCompletions endpoint at `http://localhost:18789/v1/chat/completions`. Upstream OpenClaw does not route these requests to the main agent session. We carry 4 patches on our fork to make this work.
+
+**Patch 1: Session routing via `user=main`.**
+When a CC session or external client sends a chatCompletions request, the gateway needs to know which OpenClaw session to route it to. This patch reads the `user` field from the request body. If `user=main` (or `user=openclaw`), the request routes to the main agent session (`agent:main:main`). Without this, bridge messages get "no session found" errors.
+
+```
+POST /v1/chat/completions
+Authorization: Bearer <gateway-token>
+Content-Type: application/json
+
+{"model":"openclaw","messages":[{"role":"user","content":"hi"}],"user":"main"}
+```
+
+**Patch 2-3: Steer-backlog queue integration.**
+When the agent is already busy (processing an iMessage from Parker), a concurrent chatCompletions request would fail or get dropped. These patches wire the chatCompletions endpoint into OpenClaw's `steer-backlog` queue (config: `messages.queue.mode: "steer-backlog"`). The message waits and gets processed after the current turn finishes. Works for both streaming and non-streaming responses. The gateway returns an `x-openclaw-queued: next-turn` header when a message is queued.
+
+**Patch 4: Header rename.**
+Cosmetic rename of the queue response header from `x-openclaw-queued: steer` to `x-openclaw-queued: next-turn` for clarity.
+
+**Source:** `src/gateway/openai-http.ts`. Total patch size: ~100 lines. Carried on branch `cc-mini/chat-completions-v<version>`, rebased on each OpenClaw upgrade.
+
+**Why not upstream:** OpenClaw's chatCompletions endpoint is designed for external API compatibility, not for multi-agent bridge routing. Our use case (CC sessions talking to an OpenClaw agent on the same machine) is specific to the LDM OS architecture.
+
+## Cooperative Push Architecture (Shipped Apr 11)
+
+The original bridge used a pull model: CC sessions called `lesa_check_inbox` to check for messages. Messages sat unread until the next manual check. This was replaced with a cooperative push system where messages are delivered automatically.
+
+### Four Delivery Layers
+
+Messages flow through four layers in order of priority. All four cooperate via shared `read: true` state on disk so a message delivered by one layer is skipped by the others.
+
+| # | Layer | Fires when | Hook type | File |
+|---|-------|-----------|-----------|------|
+| 1 | **asyncRewake** (Stop hook) | New message arrives while session is idle | `fs.watch` on `~/.ldm/messages/` | `src/hooks/inbox-rewake-hook.mjs` |
+| 2 | **UserPromptSubmit** | Next user prompt (typed or automated) | Claude Code hook | `src/hooks/inbox-check-hook.mjs` |
+| 3 | **SessionStart** | New CC session boots | Claude Code hook | `src/hooks/boot-hook.mjs` |
+| 4 | **Manual** | Explicit tool call | MCP tool | `lesa_check_inbox` |
+
+**Layer 1 (asyncRewake)** is the autonomous push mechanism. It holds a long-lived `fs.watch` on `~/.ldm/messages/`, uses a per-session lockfile to prevent watcher stacking, and exits code 2 on a match to wake the idle model via Claude Code's task-notification path. It fires `fireBatch()` to deliver all pending matches in one wake cycle (cost linear in unique messages, not in layers).
+
+**Layer 2 (UserPromptSubmit)** surfaces messages as `additionalContext` before each prompt. Messages appear in the session context without the user calling `lesa_check_inbox`.
+
+**Deduplication:** Each layer marks messages `read: true` on disk after delivery. Subsequent layers check this flag and skip already-delivered messages. No double delivery. Cost is linear in unique messages, not in layers.
+
+### File Inbox
+
+Messages live as JSON files at `~/.ldm/messages/`:
+
+```json
+{
+  "id": "uuid",
+  "type": "chat",
+  "from": "lesa",
+  "to": "cc-mini:session-name",
+  "body": "message text",
+  "read": false,
+  "timestamp": "2026-04-11T19:05:00-07:00"
+}
+```
+
+### Addressing
+
+| Format | Meaning |
+|--------|---------|
+| `cc-mini` | Default session of agent cc-mini |
+| `cc-mini:brainstorm` | Named session "brainstorm" on cc-mini |
+| `cc-mini:*` | Broadcast to ALL sessions of cc-mini |
+| `*` | Broadcast to all agents on the machine |
+| `lesa` | The OpenClaw agent (routes through gateway chatCompletions) |
+
+**Known issue (Apr 11):** Agent-broadcast without session specifier (`to: cc-mini`) fans out to ALL matching sessions. Three sessions replied independently to the same message. The addressing logic needs dedup for agent-broadcast targeting.
+
+### Tools
+
+| Tool | Direction | Transport |
+|------|-----------|-----------|
+| `ldm_send_message` | Any agent → file inbox | Writes JSON to `~/.ldm/messages/` |
+| `lesa_send_message` | CC → OpenClaw agent | HTTP POST to gateway chatCompletions |
+| `lesa_check_inbox` | CC ← OpenClaw agent | Reads + drains `~/.ldm/messages/` for this session |
+
+### Plan Document
+
+Full architecture: `ai/product/plans-prds/bridge/2026-04-11--cc-mini--autonomous-push-architecture.md` (377 lines, 8 open questions, Phase A shipped, Phase B deferred for CloudKit cross-machine transport).
+
 ## Node Communication (Future)
 
 Bridge currently works localhost only (Core). For Node -> Core communication:

package/docs/doc-pipeline/README.md

@@ -0,0 +1,74 @@
+# Documentation Pipeline
+
+Documentation lives in three places. They stay in sync through the installer. This is not optional.
+
+## The Three Levels
+
+### 1. Repo Docs (source of truth)
+
+Every repo has documentation at its root and in `docs/` for features:
+
+```
+repo/
+├── README.md              What this repo is
+├── TECHNICAL.md           How it works
+├── SKILL.md               Agent instructions
+├── CLAUDE.md              Agent context for Claude Code
+├── docs/
+│   └── <feature>/
+│       ├── README.md      What this feature is
+│       └── TECHNICAL.md   How this feature works
+```
+
+When a feature gets absorbed into a repo, its README and TECHNICAL move into `docs/<feature>/`.
+
+Repo docs are the source of truth. Everything else is derived from them.
+
+### 2. Home Docs (human readable, personalized)
+
+Location: `~/wipcomputerinc/library/documentation/`
+
+These are personalized for YOUR system. "Here's how releases work on YOUR machine." Generated by the installer from repo doc templates + your `~/.ldm/config.json`.
+
+The human reads these. They describe how the system is set up on this specific machine, with this specific configuration.
+
+### 3. Agent Docs (OS reference)
+
+Location: `~/.ldm/shared/`
+
+```
+~/.ldm/shared/
+├── rules/               Thin rules deployed to ~/.claude/rules/
+├── dev-guide-*.md       Org-specific dev conventions
+├── boot/                Boot sequence config
+└── prompts/             Cron prompts
+```
+
+These are what agents reference. Rules, dev guide, boot config. The installer deploys them so agents always have current instructions.
+
+### 4. ai/ (development process)
+
+Location: `<repo>/ai/`
+
+Plans, bugs, research, dev updates. Private repo only. Never ships to public. Updated by the dev team (humans + AI agents) during development.
+
+## The Update Flow
+
+### On merge to private main
+
+1. **Repo docs** updated. README, TECHNICAL, docs/<feature>/, SKILL.md, CLAUDE.md. Part of the PR. Code and docs ship together.
+2. **ai/** updated. Plan archived, bugs closed, dev update written. Notes the version is on alpha.
+
+### On `ldm install`
+
+3. **Home docs** regenerated. Installer reads repo doc templates + config.json, generates personalized `library/documentation/` files.
+4. **Agent docs** deployed. Installer copies rules, dev guide, boot config from the installed package to `~/.ldm/shared/` and `~/.claude/rules/`.
+
+### On deploy to public
+
+5. **Public repo** updated. `deploy-public.sh` syncs everything except `ai/`.
+6. **ai/** dev update notes the version moved from alpha to release.
+
+## The Rule
+
+Three places, one update, never out of sync. The installer is the bridge between "code landed" and "docs are current everywhere." Developers write repo docs. The installer propagates them. Nobody manually updates home docs or agent docs.