@linzumi/cli 0.0.45-beta → 0.0.47-beta

package/README.md

@@ -63,7 +63,7 @@ Install the CLI or run it with `npx`:
 
 ```bash
 npm install -g @linzumi/cli@latest
-npx -y @linzumi/cli@0.0.45-beta --version
+npx -y @linzumi/cli@0.0.47-beta --version
 linzumi --version
 ```
 

package/dist/index.js

@@ -937,6 +937,44 @@ function fuseQueuedMessages(selected) {
   };
 }
 
+// src/linzumiContext.ts
+function parseLinzumiConversationContext(value, warn = console.warn) {
+  if (value === undefined) {
+    return;
+  }
+  const context = objectValue(value);
+  if (context === undefined) {
+    return invalidLinzumiContext("linzumiContext must be an object", warn);
+  }
+  const threadId = stringValue(context.threadId);
+  const creatorUserId = stringValue(context.creatorUserId) ?? integerValue(context.creatorUserId)?.toString();
+  const creatorUsername = stringValue(context.creatorUsername);
+  const conversationUrl = stringValue(context.conversationUrl);
+  if (threadId === undefined || creatorUserId === undefined || creatorUsername === undefined || conversationUrl === undefined) {
+    return invalidLinzumiContext("linzumiContext must include threadId, creatorUserId, creatorUsername, and conversationUrl", warn);
+  }
+  return { threadId, creatorUserId, creatorUsername, conversationUrl };
+}
+function formatLinzumiConversationContextForPrompt(context) {
+  return `<linzumi_context>
+<linzumi_thread_id>${escapeXmlText(context.threadId)}</linzumi_thread_id>
+<linzumi_creator_user_id>${escapeXmlText(context.creatorUserId)}</linzumi_creator_user_id>
+<linzumi_creator_username>${escapeXmlText(context.creatorUsername)}</linzumi_creator_username>
+<linzumi_conversation_url>${escapeXmlText(context.conversationUrl)}</linzumi_conversation_url>
+</linzumi_context>
+
+<linzumi_pr_footer_instruction>
+For any GitHub pull request you open from this session, include this Markdown footer link in the PR description: [Continue this on Linzumi](${context.conversationUrl})
+</linzumi_pr_footer_instruction>`;
+}
+function invalidLinzumiContext(reason, warn) {
+  warn(`Ignoring invalid linzumiContext: ${reason}`);
+  return;
+}
+function escapeXmlText(value) {
+  return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
+
 // src/reconnectContext.ts
 var recentVerbatimMessageCount = 5;
 var reconnectContextModel = "openai/gpt-oss-120b";
@@ -975,7 +1013,7 @@ function filterReconnectContextMessages(messages) {
     return true;
   });
 }
-async function buildReconnectContextInjection(messages, summarizer = createConfiguredReconnectContextSummarizer()) {
+async function buildReconnectContextInjection(messages, summarizer = createConfiguredReconnectContextSummarizer(), linzumiContext) {
   const filtered = filterReconnectContextMessages(messages);
   if (filtered.length === 0) {
     throw new Error("durable Linzumi thread history did not include user-visible context");
@@ -988,6 +1026,7 @@ async function buildReconnectContextInjection(messages, summarizer = createConfi
     "",
     "The local Codex app-server thread was restarted, so this durable Linzumi thread history is being injected before retrying the latest user message.",
     "",
+    ...linzumiContext === undefined ? [] : [formatLinzumiConversationContextForPrompt(linzumiContext), ""],
     ...summary === undefined ? [] : ["Summary of earlier messages:", summary, ""],
     "Last five user-visible messages verbatim:",
     recent.map(formatReconnectContextMessage).join(`
@@ -1488,7 +1527,6 @@ var defaultIntervalMs = 2000;
 var defaultDebounceMs = 750;
 function startPortForwardWatcher(options) {
   const rootPid = options.rootPid ?? process.pid;
-  const rootCwd = normalizeCwd(options.rootCwd);
   const intervalMs = options.intervalMs ?? defaultIntervalMs;
   const debounceMs = options.debounceMs ?? defaultDebounceMs;
   const lostDebounceMs = options.lostDebounceMs ?? intervalMs * 2 + debounceMs;
@@ -1508,8 +1546,8 @@ function startPortForwardWatcher(options) {
     Promise.resolve().then(async () => {
       const descendants = descendantPidSet(scanProcesses(), rootPid);
       const sockets = scanListenSockets();
-      const candidatePids = rootCwd === undefined ? sockets.filter((socket) => descendants.has(socket.pid)).map((socket) => socket.pid) : sockets.map((socket) => socket.pid);
-      const candidates = detectedForwardCandidates(sockets, descendants, scanProcessCwds(candidatePids), { rootCwd });
+      const candidatePids = sockets.filter((socket) => descendants.has(socket.pid)).map((socket) => socket.pid);
+      const candidates = detectedForwardCandidates(sockets, descendants, scanProcessCwds(candidatePids));
       const scanTimeMs = nowMs();
       const stable = stableForwardCandidates(candidateStabilityByPort, candidates, scanTimeMs, debounceMs);
       const changes = debouncedForwardCandidateChanges(emittedByPort, missingByPort, stable.stableCandidates, scanTimeMs, lostDebounceMs);
@@ -1613,17 +1651,8 @@ function descendantPidSet(rows, rootPid) {
   }
   return descendants;
 }
-function detectedForwardCandidates(sockets, descendantPids, processCwds = new Map, options = {}) {
-  const rootCwd = normalizeCwd(options.rootCwd);
-  return sockets.filter((socket) => {
-    if (descendantPids.has(socket.pid)) {
-      return true;
-    }
-    if (rootCwd === undefined) {
-      return false;
-    }
-    return cwdMatchesRoot(processCwds.get(socket.pid), rootCwd);
-  }).filter((socket) => socket.port > 0 && socket.port < 65536).sort((left, right) => left.port - right.port).map((socket) => {
+function detectedForwardCandidates(sockets, descendantPids, processCwds = new Map) {
+  return sockets.filter((socket) => descendantPids.has(socket.pid)).filter((socket) => socket.port > 0 && socket.port < 65536).sort((left, right) => left.port - right.port).map((socket) => {
     const cwd = processCwds.get(socket.pid);
     return {
       port: socket.port,
@@ -1633,20 +1662,6 @@ function detectedForwardCandidates(sockets, descendantPids, processCwds = new Ma
     };
   });
 }
-function normalizeCwd(cwd) {
-  if (cwd === undefined) {
-    return;
-  }
-  const normalized = cwd.trim().replace(/\/+$/, "");
-  return normalized === "" ? undefined : normalized;
-}
-function cwdMatchesRoot(candidateCwd, rootCwd) {
-  const normalizedCandidate = normalizeCwd(candidateCwd);
-  if (normalizedCandidate === undefined) {
-    return false;
-  }
-  return normalizedCandidate === rootCwd || normalizedCandidate.startsWith(`${rootCwd}/`);
-}
 function parseProcessRows(output) {
   return output.split(`
 `).map((line) => line.trim()).filter((line) => line !== "").map((line) => {
@@ -2679,6 +2694,7 @@ function initialChannelSessionState(cursor, rootSeq, kandanThreadId, codexThread
     portForwardWatcher: undefined,
     activeProcessingState: undefined,
     pendingReconnectContextInjection: undefined,
+    linzumiContext: parseLinzumiConversationContext(options.channelSession.linzumiContext),
     terminalInputForwardChain: Promise.resolve(),
     webSearchProgressForwardChain: Promise.resolve(),
     typingHeartbeat: undefined,
@@ -2716,7 +2732,6 @@ function startPortForwardWatchIfEnabled(args, state, payloadContext) {
     state.approvedForwardPorts.add(port);
   }
   state.portForwardWatcher = start({
-    rootCwd: watchOptions.rootCwd ?? args.options.cwd,
     ...watchOptions,
     onCandidate: (candidate) => publishPortForwardPrompt(args, state, payloadContext, candidate),
     onCandidateLost: (candidate) => handleLostPortForwardCandidate(args, state, payloadContext, candidate),
@@ -3711,7 +3726,7 @@ async function fetchReconnectContextInjection(args, state) {
   });
   const messages = parseReconnectContextMessages(reply.messages);
   const summarizer = args.options.reconnectContextSummarizer ?? createConfiguredReconnectContextSummarizer();
-  const injection = await buildReconnectContextInjection(messages, summarizer);
+  const injection = await buildReconnectContextInjection(messages, summarizer, state.linzumiContext);
   args.log("codex.thread_reconnect_context_prepared", {
     codex_thread_id: state.codexThreadId ?? null,
     kandan_thread_id: state.kandanThreadId,
@@ -5085,7 +5100,7 @@ async function downloadQueuedKandanAttachments(args, message) {
     }
     const fileName = safeAttachmentFileName(attachment.fileName ?? attachment.id ?? `attachment-${index + 1}`, index);
     const localPath = join(directory, fileName);
-    const response = await fetch(resolveKandanAttachmentUrl(args.options.kandanUrl, url), {
+    const response = await (args.options.fetch ?? globalThis.fetch)(resolveKandanAttachmentUrl(args.options.kandanUrl, url), {
       headers: {
         authorization: `Bearer ${args.options.token}`
       }
@@ -5203,7 +5218,7 @@ async function uploadedFileIdsForCodexOutput(args, body, structured) {
     }
     const bytes = await readFile(file.path);
     const uploadBody = bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
-    const response = await fetch(resolveKandanAttachmentUrl(args.options.kandanUrl, uploadUrl), {
+    const response = await (args.options.fetch ?? globalThis.fetch)(resolveKandanAttachmentUrl(args.options.kandanUrl, uploadUrl), {
       method: uploadMethod,
       headers: { "content-type": file.contentType },
       body: uploadBody
@@ -6890,7 +6905,7 @@ function installDirectory(sourceDir, destinationDir) {
   mkdirSync3(dirname2(destinationDir), { recursive: true });
   cpSync(sourceDir, destinationDir, { recursive: true });
 }
-function codeServerEnv(env, cwd, _userDataDir, collaboration) {
+function codeServerEnv(env, cwd, userDataDir, collaboration) {
   const { PORT: _port, ...hostEnv } = env;
   const base = {
     ...hostEnv,
@@ -6904,7 +6919,8 @@ function codeServerEnv(env, cwd, _userDataDir, collaboration) {
     KANDAN_EDITOR_COLLABORATION_DEPLOYMENT_SHAPE: "local_runner_sidecar",
     KANDAN_EDITOR_COLLABORATION_ENTRY_MODE: "kandan_auto_host_or_join",
     KANDAN_EDITOR_COLLABORATION_ROOM_ID: collaboration.roomId,
-    KANDAN_EDITOR_COLLABORATION_SERVER_URL: collaboration.bootstrapServerUrl
+    KANDAN_EDITOR_COLLABORATION_SERVER_URL: collaboration.bootstrapServerUrl,
+    KANDAN_EDITOR_COLLABORATION_AUTO_HOST_CLAIM_PATH: join4(userDataDir, "kandan-oct-auto-host.lock")
   };
 }
 function collaborationEvent(collaboration) {
@@ -8484,7 +8500,7 @@ function realpathOrResolved(pathValue) {
 }
 
 // src/version.ts
-var linzumiCliVersion = "0.0.45-beta";
+var linzumiCliVersion = "0.0.47-beta";
 var linzumiCliVersionText = `linzumi ${linzumiCliVersion}`;
 
 // src/runnerLock.ts
@@ -8975,11 +8991,14 @@ async function openLocalCodexRunner(options, log, cleanup, close) {
   cleanup.actions.push(() => kandan.close());
   const topic = `local_runner:${options.runnerId}`;
   const clientId = options.machineId ?? options.runnerId;
+  const runnerHost = hostname2();
   const joinPayload = () => ({
     clientName: "kandan-local-codex-runner",
     clientId,
     runnerPid: process.pid,
     version: linzumiCliVersion,
+    hostname: runnerHost,
+    cwd: options.cwd,
     workspace: runnerWorkspaceSlug(options) ?? null,
     channel: options.channelSession?.channelSlug ?? null,
     capabilities: capabilitiesPayload()
@@ -9248,7 +9267,6 @@ async function openLocalCodexRunner(options, log, cleanup, close) {
   const seq = { value: 0 };
   const codexThreads = options.channelSession === undefined ? await discoverCodexThreads(codex, options.cwd) : [];
   const discoveredCodexThreads = { value: codexThreads };
-  const runnerHost = hostname2();
   const runtimeDefaults = runnerRuntimeDefaults(options);
   const instancePayload = {
     instanceId,
@@ -9280,10 +9298,12 @@ async function openLocalCodexRunner(options, log, cleanup, close) {
     topic,
     instanceId,
     options: {
+      kandanUrl: options.kandanUrl,
       token: options.token,
       runnerId: options.runnerId,
       cwd: options.cwd,
       codexBin: options.codexBin,
+      fetch: options.fetch,
       fast: options.fast,
       launchTui: options.launchTui,
       enablePortForwardWatch: true,
@@ -9335,10 +9355,12 @@ async function openLocalCodexRunner(options, log, cleanup, close) {
       topic,
       instanceId,
       options: {
+        kandanUrl: options.kandanUrl,
         token: options.token,
         runnerId: options.runnerId,
         cwd,
         codexBin: options.codexBin,
+        fetch: options.fetch,
         fast: control.fast ?? options.fast,
         launchTui: false,
         enablePortForwardWatch: true,
@@ -9360,6 +9382,7 @@ async function openLocalCodexRunner(options, log, cleanup, close) {
           kandanThreadId,
           rootSeq: integerValue(control.rootSeq),
           codexThreadId,
+          linzumiContext: control.linzumiContext,
           listenUser,
           model: runtimeSettings.model,
           reasoningEffort: runtimeSettings.reasoningEffort,
@@ -9868,6 +9891,7 @@ async function applyControl(codex, kandan, topic, instanceId, options, allowedCw
         }
         startupStage = "starting_codex_session";
         const developerPrompt = normalizedWorkDescription(control.developerPrompt);
+        const linzumiContext = parseLinzumiConversationContext(control.linzumiContext);
         const runtimeSettings = startInstanceRuntimeSettings(options, control);
         const response = await codex.request("thread/start", {
           cwd: cwd.cwd,
@@ -9875,7 +9899,8 @@ async function applyControl(codex, kandan, topic, instanceId, options, allowedCw
           personality: "pragmatic",
           developerInstructions: commanderDeveloperInstructions({
             cwd: cwd.cwd,
-            developerPrompt
+            developerPrompt,
+            linzumiContext
           }),
           ...runtimeSettings.model === undefined ? {} : { model: runtimeSettings.model },
           ...runtimeSettings.reasoningEffort === undefined ? {} : { reasoningEffort: runtimeSettings.reasoningEffort },
@@ -10067,6 +10092,9 @@ function commanderDeveloperInstructions(args) {
 <invoker_developer_prompt>
 ${args.developerPrompt}
 </invoker_developer_prompt>
+`;
+  const linzumiContext = args.linzumiContext === undefined ? "" : `
+${formatLinzumiConversationContextForPrompt(args.linzumiContext)}
 `;
   return `<context>
 You are a Linzumi Codex session launched by the Linzumi Commander.
@@ -10110,6 +10138,7 @@ fails.
 GOOD preview command: npm run dev -- --host 0.0.0.0 --port 8787
 BAD preview command: npm run dev -- --host 127.0.0.1
 </examples>
+${linzumiContext}
 ${customPrompt}
 <task_reminder>
 You are the Commander-launched Linzumi Codex session. Do the implementation

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linzumi/cli",
-  "version": "0.0.45-beta",
+  "version": "0.0.47-beta",
   "description": "Linzumi CLI — point a Codex agent at the real code on your laptop, with your team watching and steering from shared threads.",
   "type": "module",
   "bin": {