@linzumi/cli 0.0.46-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.46-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(`
@@ -2655,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,
@@ -3686,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,
@@ -5060,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}`
       }
@@ -5178,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
@@ -8460,7 +8500,7 @@ function realpathOrResolved(pathValue) {
 }
 
 // src/version.ts
-var linzumiCliVersion = "0.0.46-beta";
+var linzumiCliVersion = "0.0.47-beta";
 var linzumiCliVersionText = `linzumi ${linzumiCliVersion}`;
 
 // src/runnerLock.ts
@@ -9258,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,
@@ -9313,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,
@@ -9338,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,
@@ -9846,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,
@@ -9853,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 },
@@ -10045,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.
@@ -10088,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.46-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": {