@linzumi/cli 0.0.11-beta → 0.0.13-beta

package/src/channelSessionSupport.ts

@@ -8,12 +8,26 @@
   Spec: plans/2026-04-24-local-codex-runner-deep-quality-spec.md
   Relationship: Keeps local Codex version discovery bounded so channel
   availability is not blocked indefinitely by a bad executable.
+
+- Date: 2026-05-02
+  Spec: plans/2026-05-02-agent-first-zero-to-codex-launch-plan.md
+  Relationship: Keeps the npm CLI runner in parity with the legacy local
+  runner by carrying Kandan attachment metadata into queued Codex input.
 */
 import { spawnSync } from "node:child_process";
 import { hostname } from "node:os";
-import { integerValue, objectValue, stringValue } from "./json";
+import { arrayValue, integerValue, objectValue, stringValue } from "./json";
 import { type JsonObject, type JsonValue, isJsonObject } from "./protocol";
 
+export type KandanChatAttachment = {
+  readonly id: string | undefined;
+  readonly kind: string | undefined;
+  readonly fileName: string | undefined;
+  readonly contentType: string | undefined;
+  readonly sizeBytes: number | undefined;
+  readonly url: string | undefined;
+};
+
 export type KandanChatEvent = {
   readonly seq: number;
   readonly type: string;
@@ -24,6 +38,7 @@ export type KandanChatEvent = {
   readonly replyToSeq: number | undefined;
   readonly localRunnerEventType: string | undefined;
   readonly body: string;
+  readonly attachments: readonly KandanChatAttachment[];
 };
 
 export type RunnerIdentity = {
@@ -114,9 +129,45 @@ export function parseKandanChatEvent(
       stringValue(payload.body) ??
       stringValue(payload.text) ??
       "",
+    attachments: parseKandanChatAttachments(
+      arrayValue(payload.attachments) ?? arrayValue(value.attachments) ?? [],
+    ),
   };
 }
 
+function parseKandanChatAttachments(
+  attachments: readonly JsonValue[],
+): readonly KandanChatAttachment[] {
+  return attachments.flatMap(attachment => {
+    const value = objectValue(attachment);
+
+    if (value === undefined) {
+      return [];
+    }
+
+    return [
+      {
+        id: stringValue(value.id),
+        kind: stringValue(value.kind),
+        fileName:
+          stringValue(value.file_name) ??
+          stringValue(value.fileName) ??
+          stringValue(value.name),
+        contentType:
+          stringValue(value.content_type) ??
+          stringValue(value.contentType) ??
+          stringValue(value.mime_type) ??
+          stringValue(value.mimeType),
+        sizeBytes:
+          integerValue(value.size_bytes) ??
+          integerValue(value.sizeBytes) ??
+          integerValue(value.size),
+        url: stringValue(value.url),
+      },
+    ];
+  });
+}
+
 export function isCodexAuthoredEvent(
   event: Pick<
     KandanChatEvent,
@@ -206,10 +257,12 @@ export function localRunnerPayload(
   codexThreadId: string,
   context: RunnerPayloadContext,
   sourceMessageSeq?: number | undefined,
+  extraLocalRunnerMetadata?: JsonObject | undefined,
 ): JsonObject {
   return {
     metadata: {
       local_codex_runner: {
+        ...(extraLocalRunnerMetadata ?? {}),
         runner_id: options.runnerId,
         instance_id: instanceId,
         event_type: eventType,

package/src/forwardTunnel.ts

@@ -394,14 +394,15 @@ function openWebSocketStream(
 
   let opened = false;
   const pendingMessages: WebSocketPendingMessage[] = [];
-  const socket = new WebSocket(
-    localForwardWebSocketUrl(
-      scheme,
-      request.port,
-      request.path,
-      request.queryString,
-    ),
+  const url = localForwardWebSocketUrl(
+    scheme,
+    request.port,
+    request.path,
+    request.queryString,
   );
+  const protocols = webSocketProtocols(request.headers);
+  const socket =
+    protocols === undefined ? new WebSocket(url) : new WebSocket(url, protocols);
   streams.set(streamId, { kind: "websocket", socket, pendingMessages });
   socket.addEventListener("open", () => {
     opened = true;
@@ -425,6 +426,11 @@ function openWebSocketStream(
     });
   });
   socket.addEventListener("close", (event) => {
+    const stream = streams.get(streamId);
+    if (stream?.kind !== "websocket" || stream.socket !== socket) {
+      return;
+    }
+
     streams.delete(streamId);
     send({
       type: "websocket_close",
@@ -433,6 +439,11 @@ function openWebSocketStream(
     });
   });
   socket.addEventListener("error", () => {
+    const stream = streams.get(streamId);
+    if (stream?.kind !== "websocket" || stream.socket !== socket) {
+      return;
+    }
+
     streams.delete(streamId);
     if (!opened && scheme === "ws") {
       openWebSocketStream(
@@ -648,6 +659,20 @@ function requestHeaders(headers: JsonValue | undefined): Headers {
   return result;
 }
 
+function webSocketProtocols(headers: Headers): string[] | undefined {
+  const protocolHeader = headers.get("sec-websocket-protocol");
+  if (protocolHeader === null) {
+    return undefined;
+  }
+
+  const protocols = protocolHeader
+    .split(",")
+    .map((protocol) => protocol.trim())
+    .filter((protocol) => protocol !== "");
+
+  return protocols.length === 0 ? undefined : protocols;
+}
+
 function responseHeaders(headers: Headers): JsonObject[] {
   return Array.from(headers.entries())
     .filter(([name]) => !blockedFetchResponseHeaderNames.has(name.toLowerCase()))