@linzumi/cli 0.0.5-beta → 0.0.7-beta

package/src/protocol.ts

@@ -14,6 +14,29 @@
   Relationship: Defines the typed runner control that carries a Kandan
   Approve/Deny decision back to the local Codex app-server approval request
   without exposing a browser-to-runner socket.
+
+- Date: 2026-04-26
+  Spec: plans/2026-04-26-local-codex-driver-worldclass-spec.md
+  Relationship: Carries the runner streaming flush interval so live Codex
+  output can be batched before Kandan persistence without changing the logical
+  transcript protocol.
+
+- Date: 2026-04-26
+  Spec: plans/2026-04-26-local-runner-forwarding-and-editor-plan.md
+  Relationship: Defines the typed control used by Kandan to ask a connected
+  runner to perform one bounded HTTP request against an explicitly allowed
+  local preview port, and the typed control used to ask the runner to start a
+  loopback-only local code-server editor for an allowed cwd.
+
+- Date: 2026-04-26
+  Spec: plans/2026-04-26-local-runner-port-forward-approval.md
+  Relationship: Defines the typed approval control Kandan sends after the
+  in-app local port prompt is resolved by the authorized listener user.
+
+- Date: 2026-04-26
+  Spec: plans/2026-04-26-local-runner-subdomain-forwarding-epr.md
+  Relationship: Defines the typed WebSocket forwarding controls used by
+  isolated preview subdomains.
 */
 export type JsonValue =
   | null
@@ -56,14 +79,17 @@ export type JsonRpcResponse =
       };
     };
 
-export type JsonRpcMessage = JsonRpcRequest | JsonRpcNotification | JsonRpcResponse;
+export type JsonRpcMessage =
+  | JsonRpcRequest
+  | JsonRpcNotification
+  | JsonRpcResponse;
 
 export type PhoenixFrame = readonly [
   joinRef: string | null,
   ref: string | null,
   topic: string,
   event: string,
-  payload: JsonValue
+  payload: JsonValue,
 ];
 
 export type RunnerToKandanEvent =
@@ -108,6 +134,11 @@ export type KandanControl =
       readonly instanceId?: string;
       readonly cwd?: string;
       readonly launchTui?: boolean;
+      readonly model?: string;
+      readonly reasoningEffort?: string;
+      readonly approvalPolicy?: string;
+      readonly sandbox?: string;
+      readonly fast?: boolean;
     }
   | {
       readonly type: "stop_instance";
@@ -150,11 +181,73 @@ export type KandanControl =
       readonly requestId: string;
       readonly decision: "approve" | "deny";
     }
+  | {
+      readonly type: "resolve_port_forward_request";
+      readonly instanceId: string;
+      readonly requestId: string;
+      readonly decision: "approve" | "deny";
+      readonly actorUserId?: number | undefined;
+      readonly actorSlug?: string | undefined;
+    }
   | {
       readonly type: "read_thread";
       readonly instanceId: string;
       readonly threadId: string;
       readonly includeTurns?: boolean;
+    }
+  | {
+      readonly type: "forward_http_request";
+      readonly instanceId?: string;
+      readonly requestId: string;
+      readonly port: number;
+      readonly method: string;
+      readonly path: string;
+      readonly queryString?: string;
+      readonly headers?: JsonValue;
+      readonly bodyBase64?: string;
+    }
+  | {
+      readonly type: "forward_websocket_open";
+      readonly instanceId?: string;
+      readonly socketId: string;
+      readonly port: number;
+      readonly path: string;
+      readonly queryString?: string;
+      readonly headers?: JsonValue;
+    }
+  | {
+      readonly type: "forward_websocket_send";
+      readonly instanceId?: string;
+      readonly socketId: string;
+      readonly opcode: "text" | "binary" | "ping" | "pong";
+      readonly bodyBase64: string;
+    }
+  | {
+      readonly type: "forward_websocket_close";
+      readonly instanceId?: string;
+      readonly socketId: string;
+    }
+  | {
+      readonly type: "update_runner_config";
+      readonly instanceId?: string;
+      readonly allowedCwds: readonly string[];
+      readonly configVersion?: number;
+    }
+  | {
+      readonly type: "start_local_editor";
+      readonly instanceId?: string;
+      readonly requestId?: string;
+      readonly cwd: string;
+      readonly browserBaseUrl?: string;
+      readonly collaboration?: {
+        readonly provider: "oct";
+        readonly editorSessionId: number;
+        readonly runtimeSessionId: string;
+        readonly roomId: string;
+        readonly extensionAssetPath: string;
+        readonly serverAssetPath: string;
+        readonly bootstrapToken?: string;
+      };
     };
 
 export type KandanChannelSessionOptions = {
@@ -166,6 +259,7 @@ export type KandanChannelSessionOptions = {
   readonly reasoningEffort?: string | undefined;
   readonly sandbox?: string | undefined;
   readonly approvalPolicy?: string | undefined;
+  readonly streamFlushMs?: number | undefined;
 };
 
 export function parseJsonObject(text: string): JsonObject {
@@ -204,7 +298,7 @@ export function extractCodexIds(params: JsonObject): JsonObject {
     ["turnId", params.turnId],
     ["itemId", params.itemId],
     ["processId", params.processId],
-    ["requestId", params.requestId]
+    ["requestId", params.requestId],
   ].filter((entry): entry is [string, JsonValue] => entry[1] !== undefined);
 
   return Object.fromEntries(entries) as JsonObject;